Token Price History - Surf API Documentation

{ "data": [ { "timestamp": 123, "value": 123, "metric": "<string>", "symbol": "<string>" } ], "meta": { "cached": true, "credits_used": 123 }, "$schema": "<string>" }

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"

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

data

object[] | null

required

Show child attributes

API Reference

Query Parameters

Response