Binance COIN Futures

Binance COIN Margined Futures historical market data details - instruments, data coverage and data collection specifics

Binance COIN Futures historical data for all its instruments is available since 2020-06-16.

Downloadable CSV files

Historical CSV datasets for the first day of each month are available to download without API key. See downloadable CSV files documentation.

data type

symbol

date

incremental_book_L2

BTCUSD_200925

2020-07-01

Download sample

trades

BTCUSD_200925

2020-07-01

Download sample

derivative_ticker

BTCUSD_200925

2020-07-01

Download sample

API Access and data format

Historical data format is the same as provided by real-time Binance COIN Futures WebSocket API with addition of local timestamps. If you'd like to work with normalized data format instead (same format for each exchange) see downloadable CSV files or official client libs that perform data normalization client-side.

# pip install tardis-dev
import asyncio
from tardis_dev import Channel, replay

async def main():
    async for local_timestamp, message in replay(
        exchange="binance-delivery",
        from_date="2023-03-01",
        to_date="2023-03-02",
        filters=[Channel(name="depth", symbols=["btcusd_perp"])],
        api_key="YOUR_API_KEY",
    ):
        # messages as provided by Binance COIN Futures real-time stream
        print(message)

asyncio.run(main())

See Python client docs.

// npm install tardis-dev
import { replay } from 'tardis-dev';

const messages = replay({
  exchange: 'binance-delivery',
  from: '2023-03-01',
  to: '2023-03-02',
  filters: [{ channel: 'depth', symbols: ['btcusd_perp'] }],
  apiKey: 'YOUR_API_KEY'
});

// messages as provided by Binance COIN Futures real-time stream
for await (const { localTimestamp, message } of messages) {
  console.log(localTimestamp, message);
}

See Node.js client docs.

curl --compressed -g 'https://api.tardis.dev/v1/data-feeds/binance-delivery?from=2023-03-01&filters=[{"channel":"depth","symbols":["btcusd_perp"]}]&offset=0'

See HTTP API docs.

curl -g 'localhost:8000/replay?options={"exchange":"binance-delivery","filters":[{"channel":"depth","symbols":["btcusd_perp"]}],"from":"2023-03-01","to":"2023-03-02"}'

Tardis-machine is a locally runnable server that exposes API allowing efficiently requesting historical market data for whole time periods in contrast to HTTP API that provides data only in minute by minute slices.

See tardis-machine docs.

Captured real-time channels

Click any channel below to see HTTP API response with historical data recorded for it.

trade Public COIN futures trade executions stream
depth Incremental COIN futures order book updates stream. Subscribed as depth@0ms with real-time dynamically adjusted update speed.
depthSnapshot — generated channel Binance COIN Futures real-time WebSocket API does not provide initial order book snapshots. To overcome this issue we fetch initial order book snapshots from REST API and store them together with the rest of the WebSocket messages — top 1000 levels. Such snapshot messages are marked with "stream":"<symbol>@depthSnapshot" and "generated":true fields.
During data collection integrity of order book incremental updates is being validated using sequence numbers provided by real-time feed (U and u fields) — in case of detecting missed message WebSocket connection is being restarted. We also validate if initial book snapshot fetched from REST API overlaps with received depth messages.
bookTicker Best bid and best ask updates stream
forceOrder — available since 2020-07-08 Liquidation order stream publishing only the latest liquidation per symbol in each 1000ms window
markPrice Mark price and funding metrics stream subscribed as @markPrice@1s
indexPrice Index price updates stream subscribed as @indexPrice@1s
openInterest — generated channel
Snapshots are fetched from the REST open interest endpoint about every 6 seconds per instrument. Messages are marked with "stream":"<symbol>@openInterest" and "generated":true fields with REST response format.
fundingInfo — generated channel, available since 2026-03-17
Snapshots are fetched from the REST funding info endpoint every minute. Binance returns only symbols with adjusted funding cap, floor, or interval. Messages are marked with "stream":"<symbol>@fundingInfo" and "generated":true fields with REST response format.
aggTrade Aggregated COIN futures trade executions stream
ticker 24h COIN futures ticker updates stream
topLongShortAccountRatio — generated channel, available since 2020-10-28
Top trader long/short ratio (accounts), sourced by querying REST endpoint every minute
topLongShortPositionRatio — generated channel, available since 2020-10-28
Top trader long/short ratio (positions), sourced by querying REST endpoint every minute
globalLongShortAccountRatio — generated channel, available since 2020-10-28
Global long/short ratio, sourced by querying REST endpoint every minute
takerBuySellVol — generated channel, available since 2021-12-01
Taker buy/sell volume ratio, sourced by querying REST endpoint every minute
!contractInfo — available since 2023-04-01 Contract metadata updates stream pushed when listing, settlement, or bracket information changes

Market data collection details

Market data collection infrastructure for Binance COIN Futures is located in GCP asia-northeast1 region (Tokyo, Japan).

Real-time market data is captured via multiple WebSocket connections to wss://dstream.binance.com/stream.

Binance servers are located in AWS ap-northeast-1 region (Tokyo, Japan).

PreviousBinance USDS-M Futures

NextBinance European Options

Last updated 6 months ago

Was this helpful?