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

Data product · Early access

Historical NBBO and Bid/Ask Quote Data

Every change to the best bid and offer on a US stock, with sizes and venues, so you can measure the spread you'd really have paid instead of assuming you fill at the last trade.

Coverage

What you get

Item Detail
Product code STK-QUOTES
Coverage US-listed stocks and ETFs, national best bid and offer plus single-venue quotes
Granularity Every quote update, nanosecond timestamps
History Pro: 1 year. Business: full history from our source
Delivery WebSocket for live top of book; REST and downloadable files for history
Update speed Live on Pro (lower-fee venue) and Business (consolidated SIP)

Quote data is big. A busy ETF can update its NBBO many times a second, and quote history typically runs 5 to 10 times the size of trade history. Plan your storage before you order a universe.

Schema

Schema

Field Type Required Description
symbol string yes Our ticker
timestamp string yes SIP timestamp, ISO 8601 UTC, nanoseconds
participant_timestamp string optional Exchange timestamp
bid_price number yes Best bid
bid_size number yes Shares at bid (shares, not round lots)
bid_exchange string yes Venue of best bid
ask_price number yes Best ask
ask_size number yes Shares at ask
ask_exchange string yes Venue of best ask
quote_type string yes nbbo or exchange (single-venue BBO)
conditions array of strings optional Quote condition codes
tape string yes A, B, C
sequence_number number yes SIP sequence number
bid_count / ask_count number optional Orders at the level

Example record:

{
  "symbol": "SPY",
  "timestamp": "2026-11-18T15:00:00.000214876Z",
  "participant_timestamp": "2026-11-18T15:00:00.000101233Z",
  "bid_price": 598.11,
  "bid_size": 1400,
  "bid_exchange": "ARCX",
  "ask_price": 598.12,
  "ask_size": 900,
  "ask_exchange": "XNAS",
  "quote_type": "nbbo",
  "conditions": ["R"],
  "tape": "B",
  "sequence_number": 88412305
}

Sample data

Sample data

No free NBBO sample yet; US quote data needs a CTA/UTP licence before we can hand it out. A sample file is available on request. Name a symbol and a day and we'll send it in the schema above once we're able to.

Use cases

Use cases

Realistic fills in backtests. Buy at ask_price, sell at bid_price, using the quote in force at your signal's timestamp. On a mid-cap that's often the difference between a strategy that works and one that doesn't.

Spread and liquidity studies. ask_price minus bid_price, averaged by minute, shows when a stock is cheap to trade. Spreads are usually widest in the first minutes after the open.

Execution quality reviews. Line your own fills up against the NBBO at participant_timestamp and you can see whether your broker gave you price improvement or traded through the quote.

Venue analysis. bid_exchange and ask_exchange tell you which venue set the best price. Count them over a day to see where the liquidity in a name sits.

Code

Code examples

Example: SPY NBBO for the first five minutes of a session.

curl "https://api.marketdata.co/v1/stocks/quotes?symbol=SPY&quote_type=nbbo&start=2026-11-18T14:30:00Z&end=2026-11-18T14:35:00Z" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, quoted spread in basis points, averaged per second.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/stocks/quotes",
    params={
        "symbol": "SPY",
        "quote_type": "nbbo",
        "start": "2026-11-18T14:30:00Z",
        "end": "2026-11-18T14:35:00Z",
    },
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
q = pd.DataFrame(resp.json()["results"])
q["timestamp"] = pd.to_datetime(q["timestamp"], utc=True)
mid = (q["bid_price"] + q["ask_price"]) / 2
q["spread_bps"] = (q["ask_price"] - q["bid_price"]) / mid * 10_000
print(q.set_index("timestamp")["spread_bps"].resample("1s").mean().describe())

Pricing

Pricing

Plan Quotes
Pro, $79/mo Live top of book from a lower-fee venue, 1 year of NBBO history
Business, $249/mo Real-time SIP NBBO and full history, commercial internal use, exchange fees at cost

Files are planned at $25 per symbol-year of NBBO, or $149 for the whole US market for one day. Prices are early access and may change.

Among the providers we studied, paid plans with quote data run from $12 to $2,499 a month, median $99. Three have a free tier.

Side by side

How we compare

22 of the 50 providers we studied sell top-of-book quotes. Full history usually sits on the most expensive plan or behind a sales call. We put a year of NBBO in Pro, list the per-symbol file price, and let you keep the files. Field names match our trades and bars, so a quote and the trade it bracketed join on symbol and timestamp with no renaming.

FAQ

Frequently asked questions

What's the difference between NBBO and exchange quotes?

NBBO is the best bid and best offer across all US exchanges at that moment. Exchange quotes (quote_type = exchange) are one venue's own best prices, which you need for venue-level studies.

Which timestamp should I use?

Use timestamp, the SIP time, for most work. participant_timestamp is when the exchange generated the quote and is useful for latency studies.

Are sizes in shares or round lots?

Shares. Some feeds report round lots of 100; we convert so bid_size and ask_size mean the same thing everywhere.

What format are the history files?

CSV or JSON, compressed. Timestamps are UTC with nanoseconds, the same as the API.

Is the live feed licensed for display?

Not on Pro. Displaying quotes to others needs the right exchange licence, available on Business or Enterprise.

Keep reading