Skip to main content
GET
Returns historical 1-second price ticks for the same crypto feeds available on the price_feed WebSocket stream. Use this endpoint to backfill a 5-minute, 15-minute, or 1-hour chart when a user opens it part way through the market window, then keep the chart current with live price_feed events.
string
required
Asset symbol. One of BTC, ETH, SOL, BNB, XRP, DOGE, HYPE.
number
required
Start of the range as a Unix timestamp in milliseconds.
number
required
End of the range as a Unix timestamp in milliseconds.
number
default:"10000"
Maximum ticks to return. Max 100000.
string
Optional feed source filter. Valid values are chainlink_data_streams and polymarket_chainlink.

Range limits

Each request can cover up to 24 hours. If truncated is true, the response hit the requested limit; request a narrower time range or increase limit to retrieve more ticks. Historical availability starts when tick collection was enabled. Ranges before available history return an empty ticks array.

Chart backfill

For a 15-minute market, request ticks from the market window start to now, render those points, then append live WebSocket price_feed events as they arrive.

Pair with the live stream

The response uses the same event shape as the WebSocket price_feed stream. The main difference is that historical responses include an id, timestamp_ms, and optional source label for replay and deduplication.
BTC/USD can include more than one source for the same second. Deduplicate by timestamp_ms or choose a single source when your chart needs exactly one point per second.

Authorizations

x-api-key
string
header
required

Query Parameters

symbol
enum<string>
required

Asset symbol

Available options:
BTC,
ETH,
SOL,
BNB,
XRP,
DOGE,
HYPE
from
number
required

Start of the range as a Unix timestamp in milliseconds

to
number
required

End of the range as a Unix timestamp in milliseconds

limit
integer
default:10000

Maximum ticks to return

Required range: 1 <= x <= 100000
source
enum<string>

Optional feed source filter

Available options:
chainlink_data_streams,
polymarket_chainlink

Response

Historical price ticks

The response is of type object.