Python integration
Install the SDK, copy a working orderbook example, and inspect the returned DataFrame schema.
Install the SDK
One command. Every helper returns a pandas DataFrame, and works without a key on the free tier.
pip install cryptohftdataRequires Python 3.8 or newer.
Then
Build a download script
Pick what you want. The Python below updates as you go, with your API key already in it.
Exchange
Symbols
Data type
Every executed trade, with taker side.
Date rangeUTC, inclusive of both ends
to
- Pick at least one symbol to generate a runnable snippet.
Run this
Runs on the free tier without a keydownload_data.py
import cryptohftdata as chd
# Without a key this uses the free tier: 60 requests per minute per IP.
# chd.configure_client(api_key="...")
trades = chd.get_trades(
symbol="BTCUSDT",
exchange=chd.exchanges.BINANCE_FUTURES,
start_date="2026-08-18",
end_date="2026-08-18",
)
print(f"{len(trades):,} rows")
print(trades.head())Example Response
Pandas DataFrame
What the orderbook helper returns. Hover any column or value for what it means.
| event_time | received_time | symbol | event_type | side | price | quantity | transaction_time | first_update_id | final_update_id | prev_final_update_id | last_update_id |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1754078400000 | 1754078400123456789 | BTCUSDT | snapshot | bid | 114245.67000000 | 1.24500000 | <NA> | <NA> | <NA> | <NA> | 67310239112 |
| 1754078400123 | 1754078400128123456 | BTCUSDT | update | ask | 114246.10000000 | 0.38400000 | 1754078400122 | 67310239113 | 67310239116 | 67310239112 | <NA> |
| 1754078400250 | 1754078400257123456 | BTCUSDT | update | bid | 114245.50000000 | 0.00000000 | 1754078400249 | 67310239117 | 67310239120 | 67310239116 | <NA> |
| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |