ASasksurf
Market

Token Price History

Returns historical price data points for a token over a specified time range.

Time range options:

  • Predefined: 1d, 7d, 14d, 30d, 90d, 180d, 365d, max
  • Custom: use from / to (Unix seconds or YYYY-MM-DD)

Granularity is automatic based on range:

  • 1d → 5-minute intervals
  • 7d–90d → hourly
  • 180d+ → daily
get/gateway/v1/market/price

Request

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

Query parameters

symbolstring required

Single token ticker symbol like BTC, ETH, or SOL (multi-symbol not supported)

Example:BTC
time_range'1d' | '7d' | '14d' | '30d' | '90d' | '180d' | '365d' | 'max'

Window of historical data to return: 1d, 7d, 14d, 30d, 90d, 180d, 365d, or max. Ignored when from/to are set. This endpoint uses time_range only — it does NOT accept interval; bucket granularity is chosen server-side based on the window size.

Example:30d
fromstring

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

Example:2025-01-01
tostring

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

Example:2025-03-01
currencystring

Quote currency like usd, eur, or btc

Example:usd

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

project_idstring

Surf project UUID the --symbol resolved to, for frontend entity linking. Empty when the symbol is unmapped.

symbolstring

The queried ticker, normalized.

Example response

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

Changes

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