# Binance European Options

Binance European Options historical data for **all its instruments** is available since **2023-06-15**.

{% embed url="<https://api.tardis.dev/v1/exchanges/binance-european-options>" %}
See Binance European Options historical data coverage: available symbols, channels, date ranges and incidents
{% endembed %}

### 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](https://docs.tardis.dev/downloadable-csv-files/overview).

| data type             | symbol             | date       |                                                                                                                                     |
| --------------------- | ------------------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| incremental\_book\_L2 | BTC-250328-50000-C | 2024-08-01 | [Download sample](https://datasets.tardis.dev/v1/binance-european-options/incremental_book_L2/2024/08/01/BTC-250328-50000-C.csv.gz) |
| trades                | BTC-250328-50000-C | 2024-08-01 | [Download sample](https://datasets.tardis.dev/v1/binance-european-options/trades/2024/08/01/BTC-250328-50000-C.csv.gz)              |
| options\_chain        | OPTIONS            | 2024-01-01 | [Download sample](https://datasets.tardis.dev/v1/binance-european-options/options_chain/2024/01/01/OPTIONS.csv.gz)                  |

### API Access and data format

Historical data format is the same as provided by real-time Binance European Options 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](https://docs.tardis.dev/downloadable-csv-files/overview) or official [client libs](https://docs.tardis.dev/api/quickstart) that can perform data normalization client-side.

{% tabs %}
{% tab title="Python" %}

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

async def main():
    async for local_timestamp, message in replay(
        exchange="binance-european-options",
        from_date="2026-01-01",
        to_date="2026-01-02",
        filters=[Channel(name="depth20")],
        api_key="YOUR_API_KEY",
    ):
        # messages as provided by Binance European Options real-time stream
        print(message)

asyncio.run(main())
```

See [Python client docs](https://docs.tardis.dev/python-client/quickstart).
{% endtab %}

{% tab title="Node.js" %}

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

const messages = replay({
  exchange: 'binance-european-options',
  from: '2026-01-01',
  to: '2026-01-02',
  filters: [{ channel: 'depth20' }],
  apiKey: 'YOUR_API_KEY'
});

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

See [Node.js client docs](https://docs.tardis.dev/node-client/quickstart).
{% endtab %}

{% tab title="cURL & HTTP API" %}

```bash
curl --compressed -g 'https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01&filters=[{"channel":"depth20"}]&offset=0'
```

{% embed url="<https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01&filters=[{%22channel%22:%22depth20%22}]&offset=0>" %}
Example API response for Binance European Options historical market data request
{% endembed %}

See [HTTP API docs](https://docs.tardis.dev/api/http-api-reference).
{% endtab %}

{% tab title="cURL & tardis-machine" %}

```bash
curl -g 'localhost:8000/replay?options={"exchange":"binance-european-options","filters":[{"channel":"depth20"}],"from":"2026-01-01","to":"2026-01-02"}'
```

[Tardis-machine](https://docs.tardis.dev/tardis-machine/quickstart) is a locally runnable server that exposes API allowing efficiently requesting historical market data for whole time periods in contrast to [HTTP API](https://docs.tardis.dev/api/http-api-reference) that provides data only in minute by minute slices.

See [tardis-machine](https://docs.tardis.dev/tardis-machine/quickstart) docs.
{% endtab %}
{% endtabs %}

### Captured real-time channels

{% embed url="<https://developers.binance.com/docs/derivatives/options-trading/websocket-market-streams>" %}
See Binance European Options WebSocket API docs providing documentation for each captured channel's format
{% endembed %}

{% hint style="info" %}
Click any channel below to see [HTTP API](https://docs.tardis.dev/api/http-api-reference#data-feeds-exchange) response with historical data recorded for it.
{% endhint %}

**Current channels (since 2025-12-17):**

* [optionTrade](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22optionTrade%22}]) — available since **2025-12-17** Public option trade executions stream
* [depth20](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22depth20%22}]) — available since **2025-12-17** Options order book updates stream with top 20 levels subscribed as @depth20\@100ms
* [bookTicker](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22bookTicker%22}]) — available since **2025-12-17** Best bid and best ask updates stream
* [optionTicker](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22optionTicker%22}]) — available since **2025-12-17** Options ticker updates stream
* [optionMarkPrice](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22optionMarkPrice%22}]) — available since **2025-12-17** Option mark price updates stream
* [optionOpenInterest](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22optionOpenInterest%22}]) — available since **2025-12-17** Option open interest updates stream
* [optionIndexPrice](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-01-01\&filters=\[{%22channel%22:%22optionIndexPrice%22}]) — available since **2025-12-17** Option index price updates stream

**Legacy channels (eapi v1, until 2025-12-17):**

* [trade](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-06-01\&filters=\[{%22channel%22:%22trade%22}]) — available until **2025-12-17** Public options trade executions stream
* [depth100](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-01-01\&filters=\[{%22channel%22:%22depth100%22}]) — available until **2025-12-17** Options order book updates stream with top 100 levels
* [index](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-06-01\&filters=\[{%22channel%22:%22index%22}]) — available until **2025-12-17** Options index price updates stream
* [ticker](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-01-01\&filters=\[{%22channel%22:%22ticker%22}]) — available until **2025-12-17** Options ticker updates stream
* [openInterest](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-06-01\&filters=\[{%22channel%22:%22openInterest%22}]) — available until **2025-12-17** Options open interest updates stream
* [markPrice](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2024-06-01\&filters=\[{%22channel%22:%22markPrice%22}]) — available until **2025-12-17** Options mark price updates stream
* [!optionSymbol](https://api.tardis.dev/v1/data-feeds/binance-european-options?from=2026-03-01\&filters=\[{%22channel%22:%22!optionSymbol%22}]\&offset=0) — available since **2025-12-17** Option contract metadata and status updates stream

### Market data collection details

[Market data collection infrastructure](https://docs.tardis.dev/faq/general#what-is-your-infrastructure-setup) for Binance European Options is located in GCP asia-northeast1 region (Tokyo, Japan).

Real-time market data is captured via **multiple WebSocket connections** to `wss://fstream.binance.com/public/stream`.

{% hint style="info" %}
Binance servers are located in AWS ap-northeast-1 region (Tokyo, Japan).
{% endhint %}
