ASasksurf
DEX

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.

get/gateway/v1/dex/token/price

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

chain'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'optimism' | 'polygon' | 'avalanche' | 'solana' required

Chain the token lives on. Can be ethereum, base, bsc, arbitrum, optimism, polygon, avalanche, or solana.

Example:ethereum
addressstring required

Token contract address — 0x-prefixed hex (42 chars) for EVM chains, base58 for Solana. NOT a ticker symbol.

Example:0x6982508145454ce325ddbe47a25d4ec3d2311933
interval'1m' | '5m' | '15m' | '30m' | '1h' | '4h' | '12h' | '1d' | '7d'

Candle bucket size. Sub-day intervals (1m-4h) are the typical choice for active DEX analysis.

Example:1h
time_range'1h' | '6h' | '12h' | '24h' | '7d' | '30d' | '90d' | '180d' | '365d' | 'max'

Window of historical data to return. max returns the largest allowed 1500-bar window for the selected interval. Ignored when both from and to are set.

Example:24h
fromstring

Start of custom date range (Unix seconds or YYYY-MM-DD). Must be set together with to. Overrides time_range when set.

Example:2026-01-01
tostring

End of custom date range (Unix seconds or YYYY-MM-DD). Must be set together with from. Overrides time_range when set.

Example:2026-01-02

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseDexTokenPriceBar.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.