Data
Reference Prices
Spot candles and tick-level trades for crypto underlyings at 1-second resolution.
GET
/reference/candlessdk
client.reference.candles(symbol, **params)1-second OHLCV candles for a crypto underlying.
Parameters
symbolstrrequired
"BTC", "ETH", "SOL", "XRP", "BNB", "DOGE", "LINK", "ENA".
afterint
Candles at or after this timestamp (ms, inclusive).
beforeint
Candles before this timestamp (ms, exclusive).
orderstr= "asc"
Sort direction.
limitint= 500
Results per page.
candles = client.reference.candles(
"BTC", after="2024-03-10", before="2024-03-14"
)
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
Trades at or after this timestamp (ms, inclusive).
beforeint
Trades before this timestamp (ms, exclusive).
orderstr= "asc"
Sort direction.
limitint= 500
Results per page.
trades = client.reference.trades(
"BTC", after="2024-03-10", before="2024-03-10T01:00"
)
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 }
}