Metadata-Version: 2.4
Name: tickstream
Version: 0.1.0
Summary: Realtime CME futures, options & Level 2 market data — one key, one line.
License: MIT
Project-URL: Homepage, https://tick-stream.xyz
Project-URL: Documentation, https://tick-stream.xyz/docs
Keywords: market-data,futures,options,cme,websocket,trading,ticks,level2
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: websocket-client>=1.7

# tickstream (Python)

Realtime CME futures, options & Level 2 — one key, one line.

```bash
pip install tickstream
```

## Stream ticks

```python
from tickstream import Stream

for tick in Stream("sk_live_…").subscribe("ES", "NQ"):
    print(tick.symbol, tick.price, tick.size, tick.side)
```

## Level 2 & options (Pro plans)

```python
from tickstream import Stream

for book in Stream("sk_live_…").book("ES"):
    print(book.bids[0], book.asks[0], book.imbalance)

for o in Stream("sk_live_…").options("ES", "SPX"):
    print(o.symbol, o.strike, o.right, o.iv, o.delta)
```

## REST: quotes, backfill, reference data

```python
from tickstream import Client

api = Client("sk_live_…")
api.quote("ES")
api.ticks("ES", start="2025-06-01T13:30:00Z", end="2025-06-01T20:00:00Z")
api.symbols()
api.options("SPX", expiry="2026-06-19")
```

Each message supports attribute **and** dict access (`tick.price` or `tick["price"]`).

Get your API key at <https://tick-stream.xyz>. Full docs: <https://tick-stream.xyz/docs>.
Point at a local gateway with `TICKSTREAM_WS_URL` / `TICKSTREAM_API_URL`.
