Token Price History

GET /gateway/v1/market/price

Token Price History

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/market/price

200

{
  "data": [
    {
      "timestamp": 123,
      "value": 123,
      "metric": "<string>",
      "symbol": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "https://example.com/schemas/SimpleListResponseMarketMetricPoint.json"
}

Query Parameters

symbol · string · required

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

Example:

"BTC"

time_range · enum<string> · default: 30d

Predefined time range for historical data. Ignored when from/to are set. Can be 1d, 7d, 14d, 30d, 90d, 180d, 365d, or max.

Available options: 1d, 7d, 14d, 30d, 90d, 180d, 365d, max

Example:

"30d"

from · string

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"

to · string

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"

currency · string · default: usd

Quote currency like usd, eur, or btc

Example:

"usd"

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/SimpleListResponseMarketMetricPoint.json"