
curl -X POST https://api.orthogonal.com/v1/run \
-H 'Authorization: Bearer orth_live_••••' \
-H 'Content-Type: application/json' \
-d '{
"api": "surf",
"path": "/gateway/v1/exchange/candles",
"method": "GET",
"query": {
"exchange": "",
"pair": "",
"limit":
}
}'
{
"success": true,
"data": {
"data": [ 1 item ],
"meta": { … },
"$schema": "https://api.asksurf.ai/schemas/DataResponseExchangeCandleItem.json"
}
}
A real response, recorded when Orthogonal checked this endpoint.
$0.00654per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Exchange Historical Candles: Returns persisted OHLCV candles for a covered Bithumb, Upbit, HashKey, bitFlyer, Coinone, or Korbit spot market.
Intervals: 5m, 4h, and 1w. bitFlyer is currently reliable for weekly (1w) OHLCV only.
Pagination: use from/to to bound the time range and limit to cap returned candles. Results are ordered newest first.
Synthetic candles: include_synthetic=true by default, so carry-forward candles for no-trade intervals are included for continuous charts. Set include_synthetic=false for raw exchange-only candles. Sparse Korbit markets may rely on synthetic rows to keep charts continuous.
Query parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed