Coverage
What you get
| Item | Detail |
|---|---|
| Product code | STK-BREADTH |
| Coverage | Universes NYSE, NASDAQ, SP500 and ALL_US |
| Granularity | Intraday on Pro; daily on Starter |
| History | Daily breadth history planned as a one-off file |
| Delivery | REST; history file download |
| Update speed | During the session for intraday series; after the close for daily |
Breadth series are counts and ratios across a universe of stocks, not prices of any one thing. tick is the number of stocks whose last trade was an uptick minus those on a downtick. trin, the Arms index, divides the advance/decline ratio by the up/down volume ratio. Below 1 means volume is flowing into rising stocks.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Our breadth series code, e.g. BREADTH.NYSE.ADV_DEC |
timestamp |
string | yes | ISO 8601 UTC (or date for daily series) |
universe |
string | yes | NYSE, NASDAQ, SP500, ALL_US |
advancers |
number | optional | Stocks up |
decliners |
number | optional | Stocks down |
unchanged |
number | optional | Stocks flat |
new_highs |
number | optional | 52-week highs |
new_lows |
number | optional | 52-week lows |
up_volume |
number | optional | Volume in rising stocks |
down_volume |
number | optional | Volume in falling stocks |
tick |
number | optional | Upticks minus downticks |
trin |
number | optional | Arms index |
Example record:
{
"symbol": "BREADTH.NYSE",
"timestamp": "2026-11-18T21:00:00Z",
"universe": "NYSE",
"advancers": 1843,
"decliners": 912,
"unchanged": 97,
"new_highs": 141,
"new_lows": 38,
"up_volume": 2914000000,
"down_volume": 1220000000,
"tick": 412,
"trin": 0.84
}
The values are an example. You can check the trin from the other fields: (1843 / 912) / (2914000000 / 1220000000) comes to about 0.84.
Sample data
Sample data
There isn't a free breadth sample yet, because the stock bars it's computed from aren't live. Ask for a universe and date range and we'll send a sample file as soon as we can build one.
Use cases
Use cases
TICK extremes for intraday entries. Many index futures traders watch for tick readings beyond plus or minus 1,000 as signs of program buying or selling. Pull the series at 1-minute resolution and test what ES did over the next 15 minutes after each extreme.
Trend day filter. On strong trend days, advancers outnumber decliners by a wide margin from the first hour and trin stays well below 1. Use the 10:30 a.m. reading to decide whether to fade moves or go with them.
Divergence at highs. If the S&P 500 makes a new high while new_highs in the SP500 universe falls, fewer stocks are carrying the index. Plot the two on the same chart to spot it.
Regime features for models. Daily up_volume / down_volume and the cumulative advance/decline line make cheap features for a machine learning model that decides when to be in the market.
Code
Code examples
Example: NYSE breadth for one session with curl.
curl "https://api.marketdata.co/v1/indices/breadth?universe=NYSE&interval=1m&date=2026-11-18" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, count TICK extremes per day.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/indices/breadth",
params={"universe": "NYSE", "interval": "1m", "start": "2026-11-01", "end": "2026-11-18"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
b = pd.DataFrame(resp.json()["results"])
b["timestamp"] = pd.to_datetime(b["timestamp"])
b["day"] = b["timestamp"].dt.tz_convert("America/New_York").dt.date
extremes = b.assign(hi=b["tick"] >= 1000, lo=b["tick"] <= -1000)
print(extremes.groupby("day")[["hi", "lo"]].sum())
Pricing
Pricing
| Plan | Breadth |
|---|---|
| Starter, $29/mo | Daily breadth series |
| Pro, $79/mo | Intraday TICK, TRIN, advance/decline and up/down volume |
A daily breadth history file is planned at $29 one-off. Prices are early access and may change.
Vendors we studied charge $30 to $108.15 a month for breadth data, based on 2 prices.
Side by side
How we compare
Only 2 of the 50 providers we studied sell breadth and internals: one as a real-time stream for a desktop platform, one as end-of-day series in a local app. We plan to serve both intraday and daily over a plain REST API, computed from our own consolidated stock bars, with the method written down. Field names stay the same whether you ask for NYSE or the S&P 500.
FAQ
Frequently asked questions
Is this the same as the official NYSE TICK?
It's computed by us from consolidated trades, using the standard definition. Our numbers can differ slightly from a feed that counts only NYSE-reported trades, so we'll document the method next to the data.
Which universes are included?
NYSE, NASDAQ, SP500 and ALL_US. Each one is a separate series with the same fields.
What time zone are timestamps in?
UTC. The regular US session runs 14:30 to 21:00 UTC in winter and 13:30 to 20:00 UTC in summer.
Is it real-time or delayed?
Intraday series on Pro are planned to update during the session. Daily series on Starter publish after the close.
Are breadth figures adjusted for splits?
They don't need to be. Advancers and decliners compare each stock with its own prior close, and that comparison already accounts for corporate actions.
Can I download the history?
Yes, a daily history file is planned at $29 one-off, in CSV and Parquet.
Keep reading
Related
- Asset hub: Stocks
- Stocks: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: indices
- Learn: Market breadth indicators