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
Related
- Asset hub: Stocks
- Stocks: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: stock trades and quotes
- Learn: NBBO explained, Tick data vs bar data