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