Coverage
What you get
| Item | Detail |
|---|---|
| Product code | STK-SNAPSHOT |
| Coverage | US-listed stocks and ETFs |
| Granularity | Latest state per symbol, plus a movers list |
| History | None. This is a live snapshot; for history use daily or intraday bars |
| Delivery | REST, batch calls of up to 250 symbols |
| Update speed | End of day on Free, 15-minute delayed on Starter, real time from Pro |
"Real time" means different things at different vendors. Some pass through the full consolidated tape, some use a single exchange, and some sell a derived price. We tell you which one you got on every record, in price_source, along with an is_delayed flag.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Our ticker |
timestamp |
string | yes | Time of the latest update, ISO 8601 UTC |
last_price |
number | yes | Last trade price |
last_size |
number | optional | Last trade size |
last_trade_timestamp |
string | optional | Time of the last trade |
bid_price |
number | optional | Best bid |
bid_size |
number | optional | Shares at best bid |
ask_price |
number | optional | Best ask |
ask_size |
number | optional | Shares at best ask |
mid_price |
number | optional | (bid + ask) / 2 |
open |
number | yes | Session open |
high |
number | yes | Session high |
low |
number | yes | Session low |
volume |
number | yes | Session volume |
vwap |
number | optional | Session VWAP |
previous_close |
number | yes | Prior regular-session close |
change |
number | yes | last_price minus previous_close |
change_percent |
number | yes | Change as a percent |
pre_market_price |
number | optional | Latest pre-market trade |
after_hours_price |
number | optional | Latest after-hours trade |
fifty_two_week_high |
number | optional | 52-week high |
fifty_two_week_low |
number | optional | 52-week low |
market_cap |
number | optional | Shares outstanding x last price |
is_market_open |
boolean | optional | Whether the regular session is open |
is_delayed |
boolean | yes | True if delayed |
price_source |
string | yes | sip, iex, nasdaq_basic, derived |
The movers endpoint returns the same record with two extra fields: list_type (gainers, losers or most_active) and rank.
Example record:
{
"symbol": "TSLA",
"timestamp": "2026-11-18T15:42:07.381Z",
"last_price": 341.28,
"last_size": 100,
"last_trade_timestamp": "2026-11-18T15:42:07.381Z",
"bid_price": 341.25,
"bid_size": 300,
"ask_price": 341.3,
"ask_size": 200,
"mid_price": 341.275,
"open": 335.1,
"high": 343.9,
"low": 333.42,
"volume": 61248930,
"vwap": 339.84,
"previous_close": 334.65,
"change": 6.63,
"change_percent": 1.98,
"fifty_two_week_high": 488.54,
"fifty_two_week_low": 214.25,
"is_market_open": true,
"is_delayed": false,
"price_source": "iex"
}
Sample data
Sample data
No free sample yet. A snapshot only makes sense live, and live US prices need an exchange or derived source we haven't signed. If you want to see a file for your watchlist, ask and we'll send one as soon as we can.
Use cases
Use cases
Watchlist dashboards. One batch call refreshes 250 tickers. last_price, change_percent and volume fill a table; is_market_open tells your UI whether to grey it out.
Gap and momentum scanners. Pull the gainers list before the open, then check pre_market_price against previous_close to find names that are moving on real volume rather than a single print.
Spread checks before you send an order. bid_price, ask_price and their sizes tell you if the market is wide enough to need a limit order. mid_price is already computed.
52-week breakout alerts. Compare last_price with fifty_two_week_high on every refresh and fire an alert when it crosses.
Code
Code examples
Example: three symbols in one request.
curl "https://api.marketdata.co/v1/stocks/snapshot?symbols=TSLA,AAPL,MSFT" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, today's top gainers into a DataFrame.
import os
import requests
import pandas as pd
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
resp = requests.get(
"https://api.marketdata.co/v1/stocks/movers",
params={"list_type": "gainers", "limit": 20},
headers=headers,
)
resp.raise_for_status()
movers = pd.DataFrame(resp.json()["results"])
print(movers[["rank", "symbol", "last_price", "change_percent", "volume", "price_source"]])
Pricing
Pricing
| Plan | Snapshots and movers |
|---|---|
| Free, $0 | Prior-close snapshots and end-of-day movers |
| Starter, $29/mo | 15-minute delayed snapshots and movers |
| Pro, $79/mo | Real time from a low-fee source, with price_source shown |
| Business, $249/mo | Consolidated (SIP) real time, commercial internal use |
Batch calls of up to 250 symbols work on every plan. Snapshots are not sold as a dataset. Prices are early access and may change.
For comparison, paid plans with quote snapshots cost $12 to $150 a month across the vendors we studied, with a median of $49.99, and eight of them offer a free tier.
Side by side
How we compare
22 of the 50 providers we studied sell a quote or snapshot endpoint, so you have plenty of choice. Our pitch is narrow. Prices are public, the record shape matches our bars and options chain (same symbol, same UTC timestamps, numbers as numbers), and we label the price source on every row instead of leaving you to find out from a footnote that "real time" meant one exchange.
FAQ
Frequently asked questions
Is this the full consolidated tape?
On Business, yes: SIP-based real time. On Pro the price comes from a lower-fee source, and price_source says which one (iex, nasdaq_basic or derived).
How many symbols can I request at once?
Up to 250 per call on every plan. Rate limits per minute depend on the plan.
Does it include pre-market and after-hours prices?
Yes, in separate fields: pre_market_price and after_hours_price. last_price is the latest trade from any session.
What time zone are timestamps in?
UTC, ISO 8601. previous_close always refers to the prior regular-session close at 16:00 New York time.
Can I show these quotes in my own app?
Not on Free, Starter or Pro, which are for personal use. Displaying quotes to other people needs a display licence, which starts at Business or Enterprise depending on the source.
Keep reading
Related
- Asset hub: Stocks
- Symbols: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: stock snapshot
- Learn: NBBO explained