Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Level 2 Stock Data: Order Book Depth (L2 and L3)

Who was queued behind the best bid, how deep the offer really was, and which orders got pulled a millisecond before your fill.

Depth of book sits late on our roadmap. It isn't live, and it will start as an Enterprise product because of exchange fees. You can reserve early access now so we know which venues and symbols to license first.

Coverage

What you get

Item Detail
Product code STK-BOOK
Coverage US equities, one book per venue (for example XNAS)
Granularity Every book event, nanosecond timestamps; L2 by price level, L3 by individual order
History Per venue-day files on request once the line opens
Delivery Streaming and files, Enterprise only
Update speed Event by event

Level 1 is the best bid and ask. Add the price levels behind it, usually 10 deep, and you have Level 2. With Level 3, also called market by order, you see each resting order with its own order_id, and can follow one order from add through modify to fill or cancel.

Schema

Schema

Field Type Required Description
symbol string yes Our ticker
timestamp string yes Exchange event time, ISO 8601 UTC, nanoseconds
received_timestamp string optional Our capture time
exchange string yes Venue MIC (book is per venue)
action string yes add, modify, cancel, trade, fill, clear
side string yes bid or ask
price number yes Order price
size number yes Order size
order_id string optional Venue order ID (L3 / MBO only)
level number optional Book level 0 to 9 (MBP only)
order_count number optional Orders at level (MBP)
market_maker string optional MPID if attributed
sequence_number number yes Venue sequence
flags number optional Snapshot, last-in-event markers

Example record:

{
  "symbol": "AAPL",
  "timestamp": "2026-11-18T14:45:10.118204551Z",
  "received_timestamp": "2026-11-18T14:45:10.118219004Z",
  "exchange": "XNAS",
  "action": "add",
  "side": "bid",
  "price": 228.4,
  "size": 300,
  "order_id": "7741029384112",
  "sequence_number": 551028344
}

Prices in the record are an example only.

Sample data

Sample data

We don't have a free depth sample. Book data is licensed per venue, and we haven't signed those licences yet. Send us a symbol, a venue and a date and we'll come back with what a sample would cost and when we can provide it.

Use cases

Use cases

Queue position for fill modelling. A backtest that assumes every limit order at the bid fills is lying to you. Replay add, cancel and fill events with their order_id and you can estimate where your order would have sat and whether it would have traded.

Spoofing and pulled liquidity. Large orders that appear and vanish before price reaches them show up as an add followed by a cancel on the same order_id, often within milliseconds. Count them by level and side.

Book imbalance signals. Sum size on the bid against the ask across levels 0 to 4, every 100 milliseconds. Short-horizon traders use that ratio to lean on the next tick.

Execution research. Compare timestamp with received_timestamp to measure feed latency, and use sequence_number to prove no messages went missing in your capture.

Code

Code examples

Example: a short window of Nasdaq book events with curl.

curl "https://api.marketdata.co/v1/stocks/book?symbol=AAPL&exchange=XNAS&start=2026-11-18T14:45:00Z&end=2026-11-18T14:45:05Z" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, rebuild top-of-book size imbalance from L2 events.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/stocks/book",
    params={"symbol": "AAPL", "exchange": "XNAS", "depth": "mbp-10",
            "start": "2026-11-18T14:45:00Z", "end": "2026-11-18T14:50:00Z"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
book = pd.DataFrame(resp.json()["results"])
book["timestamp"] = pd.to_datetime(book["timestamp"])

top = book[book["level"] == 0].pivot_table(
    index="timestamp", columns="side", values="size", aggfunc="last"
).ffill()
top["imbalance"] = (top["bid"] - top["ask"]) / (top["bid"] + top["ask"])
print(top.resample("1s").last().tail())

Pricing

Pricing

Plan Level 2 and Level 3
Enterprise, quote Streaming and historical depth by venue, with exchange fees passed through at cost

Depth of book won't be on Free, Starter, Pro or Business. Exchange fees for full-depth feeds are charged per firm and per user, and they run higher than any self-serve plan we could set. Per venue-day history files are planned later, on request.

Vendors we studied charge $195.30 to $2,499 a month for depth, median $199, based on 3 prices, and most of those add exchange fees on top.

Side by side

How we compare

Only 5 of the 50 providers we studied sell stock order book data, and most of them sell it as a stream you can't keep. Ours will be built around files: per venue-day, in the same column names as our trades and quotes, so a book file and a trade file join on symbol and timestamp with no renaming. We'll show exchange fees as a separate line, not buried in a bundle.

FAQ

Frequently asked questions

What's the difference between L2 and L3?

L2 shows the total size at each price level. L3 shows every individual order, each with an order_id, so you can track a single order's life in the book.

Which exchanges will you cover?

We plan to start with the venues early access requests ask for most. Each one is a separate licence, so we'll list them as they're signed.

Is the book consolidated across venues?

No. Each record carries an exchange MIC and belongs to that venue's book. You can combine them yourself, and we may add a consolidated view later.

What time zone are timestamps in?

UTC, ISO 8601, to the nanosecond. Subtract 4 or 5 hours for US Eastern depending on daylight saving time.

Can I get real-time depth?

On Enterprise, yes, once the venue licences are in place. Real-time depth always carries the exchange's own per-user fee.

What formats will files come in?

Compressed CSV and Parquet per venue per day, plus JSON from the API.

Keep reading