DEX token price candles

GET/gateway/v1/dex/token/price

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/dex/token/price",
"method": "GET",
"query": {
"chain": "",
"address": ""
}
}'
{
"success": true,
"data": {
"data": [ 25 items ],
"meta": { … },
"$schema": "https://api.asksurf.ai/schemas/SimpleListResponseDexTokenPriceBar.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

DEX Token OHLCV Price: Returns DEX-pool-weighted OHLCV bars (timestamp, open, high, low, close, volume_usd) for a single token identified by chain + address. USD only. Bars are sorted ascending by timestamp. Use for meme coins, newly-launched tokens, and any DEX-native asset where /v1/market/price returns nothing. Prefer the standard /v1/market/price for major listed tokens (BTC, ETH, etc.). Time window: time_range (default 24h) sets the window; from+to (Unix seconds or YYYY-MM-DD) override it. Bars use closed-interval semantics, so 24h × 1h returns 25 bars. Maximum 1500 bars per call — combinations exceeding the cap (e.g. 30d × 5m) return 422. time_range=max returns the largest allowed 1500-bar window for the selected interval. Identity: chain (enum) + address (EVM hex or Solana base58). No symbol input.

Query parameters

Response types

More from Surf API

  1. KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
  2. Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
  3. Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
  4. KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
  5. Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
  6. Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
  7. Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
  8. Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
  9. Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
  10. Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
  11. Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
  12. KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed
All 145 Surf API endpoints