Data
Reference Prices
Spot candles and tick-level trades for crypto underlyings at 1-second resolution.
GET
/reference/candlessdk
client.reference.candles(symbol, **params)OHLCV candles for a crypto underlying. Native resolution is 1-second; coarser resolutions are aggregated server-side.
Parameters
symbolstrrequired
"BTC", "ETH", "SOL", "XRP", "BNB", "DOGE", "LINK", "ENA".
afterint | str
Candles at or after this time, inclusive (ms epoch or ISO 8601).
beforeint | str
Candles before this time, exclusive (ms epoch or ISO 8601).
resolutionstr= "1s"
Bucket size: 1s, 5s, 10s, 30s, 1m, 5m, 15m, 1h, 4h, 1d.
orderstr= "asc"
Sort direction.
limitint= 500
Results per page.
takeint
SDK only. Caps total items returned across pages.
candles = client.reference.candles(
"BTC",
after="2026-04-15T01:45:00Z",
before="2026-04-15T01:50:00Z",
resolution="1s",
)
df = candles.to_dataframe()
print(df[["close", "volume"]].describe())jsonResponse
{
"data": [{
"symbol": "BTC",
"timestamp": 1710400000000,
"open": 84250.10,
"high": 84251.30,
"low": 84249.80,
"close": 84250.90,
"volume": 0.4215
}],
"meta": { "cursor": "...", "has_more": true }
}GET
/reference/tradessdk
client.reference.trades(symbol, **params)Tick-level aggregated trades for a crypto underlying.
Parameters
symbolstrrequired
"BTC", "ETH", or "SOL".
afterint | str
Trades at or after this time, inclusive (ms epoch or ISO 8601).
beforeint | str
Trades before this time, exclusive (ms epoch or ISO 8601).
orderstr= "asc"
Sort direction.
limitint= 500
Results per page.
takeint
SDK only. Caps total items returned across pages.
trades = client.reference.trades(
"BTC",
after="2026-04-15T01:45:00Z",
before="2026-04-15T01:46:00Z",
)
df = trades.to_dataframe()
print(df[["price", "quantity"]].head())jsonResponse
{
"data": [{
"symbol": "BTC",
"timestamp": 1710400000123,
"price": 84250.50,
"quantity": 0.0012,
"is_buyer_maker": false
}],
"meta": { "cursor": "...", "has_more": true }
}