Binance

Telonex provides historical spot market data from Binance, the world's largest crypto exchange by volume. This data is useful for trading crypto prediction markets — correlating spot prices with prediction market activity on markets like "Will BTC be above $100k?"

Data Availability

• Spot data (trades, quotes, book snapshots): from 2026-02-06
• Instruments: btcusdt, ethusdt, solusdt, xrpusdt
• Updated daily, within hours of midnight UTC

Available Instruments

Symbol	Pair
btcusdt	BTC / USDT
ethusdt	ETH / USDT
solusdt	SOL / USDT
xrpusdt	XRP / USDT

Available Channels

Channel	Description
trades	All executed trades
quotes	Top-of-book quotes
book_snapshot_5	5-level order book depth
book_snapshot_25	25-level order book depth

How Data is Collected

All streams use timeUnit=MICROSECOND for microsecond-precision timestamps.

Streams captured:

• Trade Streams (<symbol>@trade) — every executed trade
• Diff. Depth Stream (<symbol>@depth@100ms) — orderbook depth updates every 100ms, used to maintain a full orderbook and produce quotes and book snapshots

Not captured:

• Individual Symbol Book Ticker (<symbol>@bookTicker) — provides best bid/ask but does not include a timestamp field, so accurate exchange timestamps cannot be assigned. Quotes are derived from the depth stream instead.

How streams map to output channels:

Source stream	Output channels
@trade	trades
@depth@100ms	quotes, book_snapshot_5, book_snapshot_25

note

book_snapshot_full is not available for Binance — maximum depth is 25 levels.

Identifiers

Binance identifiers are simple — the symbol is the identifier. slug, market_id, and asset_id are all interchangeable and all equal the lowercase symbol name (e.g. btcusdt).

There is no outcome or outcome_id for Binance (unlike prediction markets which have Yes/No outcomes). These parameters are ignored if provided.

Download Examples

from telonex import get_dataframe

# By slug (recommended)
df = get_dataframe(
    api_key="YOUR_API_KEY",
    exchange="binance",
    channel="trades",
    from_date="2026-02-19",
    to_date="2026-02-20",
    slug="btcusdt",
)

# By asset_id (equivalent)
df = get_dataframe(
    api_key="YOUR_API_KEY",
    exchange="binance",
    channel="quotes",
    from_date="2026-02-19",
    to_date="2026-02-20",
    asset_id="btcusdt",
)

# curl
curl -L "https://api.telonex.io/v1/downloads/binance/trades/2026-02-19?slug=btcusdt" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o btcusdt_trades.parquet