Skip to main content
GET
/
gateway
/
v1
/
market
/
price
Token Price History
curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/market/price
{
  "data": [
    {
      "timestamp": 123,
      "value": 123,
      "metric": "<string>",
      "symbol": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

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