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.
from datetime import datetime, timedelta, timezone
end = datetime.now(timezone.utc) - timedelta(days=1)
candles = client.reference.candles(
"BTC",
after=end - timedelta(minutes=5),
before=end,
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", "SOL", "XRP", "BNB", "DOGE", "LINK", "ENA".
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.
from datetime import datetime, timedelta, timezone
end = datetime.now(timezone.utc) - timedelta(days=1)
trades = client.reference.trades(
"BTC",
after=end - timedelta(minutes=1),
before=end,
)
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 }
}