Coverage
What you get
| Item | Detail |
|---|---|
| Product code | IDX-BREADTH |
| Coverage | Breadth universes such as NYSE, NASDAQ and SPX members |
| Granularity | 1d with full history on Starter; 1m intraday on Pro |
| History | Full daily history on Starter |
| Delivery | REST, CSV files per universe |
| Update speed | After the close on Starter; minute by minute on Pro |
An index can rise on the back of a handful of giant stocks while most of the market falls. Breadth is how you see that. We compute every figure ourselves from the same stock bars we sell, so the counts are consistent from day to day and you can rebuild any number from the underlying data.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Breadth universe ID, e.g. NYSE, NASDAQ, SPX |
interval |
string | yes | 1m or 1d |
timestamp / date |
string | yes | Bar start or session date |
advancers, decliners, unchanged |
number | yes | Issue counts |
advancing_volume, declining_volume |
number | yes | Shares |
new_highs_52w, new_lows_52w |
number | daily | 52-week highs and lows |
percent_above_50d_ma, percent_above_200d_ma |
number | daily | Share of members above moving averages |
tick |
number | optional (intraday) | Upticks minus downticks |
trin |
number | optional | Arms index: (adv/dec) / (adv vol/dec vol) |
Example record:
{
"symbol": "NYSE",
"interval": "1d",
"date": "2026-11-18",
"advancers": 1784,
"decliners": 1012,
"unchanged": 88,
"advancing_volume": 612455300,
"declining_volume": 401227900,
"new_highs_52w": 96,
"new_lows_52w": 41,
"percent_above_50d_ma": 58.3,
"percent_above_200d_ma": 63.1,
"trin": 1.15
}
In the example, TRIN is (1784 / 1012) / (612,455,300 / 401,227,900), which comes to about 1.15. A reading above 1 means declining stocks are taking a larger share of volume than their count alone would suggest.
Sample data
Sample data
No free breadth sample yet. It's built from our US stock bars, which need their exchange licence before we can share derived files. A sample file is available on request for any universe.
Use cases
Use cases
Advance/decline line. Take advancers minus decliners each day and keep a running total. When the S&P 500 makes a new high and the A/D line doesn't, fewer stocks are carrying the rally.
Trend health filters. percent_above_200d_ma below 40 while the index sits near its highs is a classic warning of a narrow market. Test it as a filter on your long entries.
Intraday internals. On Pro, 1-minute tick readings at extremes (very positive or very negative) are where many day traders look for exhaustion. Pair them with trin to see whether volume agrees.
New highs vs new lows. A market making new highs while new_lows_52w is also rising is splitting into winners and losers. The two series together say more than either alone.
Code
Code examples
Example: daily NYSE breadth since 2020.
curl "https://api.marketdata.co/v1/indices/breadth?symbol=NYSE&interval=1d&start=2020-01-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, the cumulative advance/decline line.
import os
import requests
import pandas as pd
resp = requests.get(
"https://api.marketdata.co/v1/indices/breadth",
params={"symbol": "NYSE", "interval": "1d", "start": "2020-01-01"},
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
b = pd.DataFrame(resp.json()["results"])
b["date"] = pd.to_datetime(b["date"])
b = b.set_index("date").sort_index()
b["ad_line"] = (b["advancers"] - b["decliners"]).cumsum()
print(b[["ad_line", "new_highs_52w", "new_lows_52w", "percent_above_200d_ma"]].tail())
Pricing
Pricing
| Plan | Market breadth |
|---|---|
| Starter, $29/mo | End-of-day breadth, full history |
| Pro, $79/mo | Adds 1-minute intraday breadth, including TICK and TRIN |
A full daily history file is planned at $49 per universe. Prices are early access and may change.
Only two of the vendors we studied price breadth data, at $30 and $108.15 a month.
Side by side
How we compare
Just 2 of the 50 providers we studied sell breadth data, and neither publishes a field layout. We designed ours around the stats traders name most often, wrote the formulas down, and price daily history at $29 a month or as a file. The counts come from our own stock bars, so they line up with the prices you'd use to check them.
FAQ
Frequently asked questions
Which stocks are in each universe?
NYSE and NASDAQ cover common stocks listed on each exchange; SPX covers current S&P 500 members on each date. The exact inclusion rules, such as how ETFs and preferreds are treated, will be published in the docs.
How is TRIN calculated?
(advancers / decliners) divided by (advancing volume / declining volume). Below 1 leans bullish, above 1 leans bearish.
What is TICK?
The number of stocks whose last trade was an uptick minus the number on a downtick, at that moment. It's an intraday reading, so it's only in the 1-minute data.
Are moving-average figures daily only?
Yes. percent_above_50d_ma, percent_above_200d_ma and the 52-week high and low counts are daily fields.
What time zone are intraday bars in?
UTC, stamped at the bar start, like the rest of our intraday data.
Keep reading
Related
- Asset hub: Indices
- Indices: S&P 500, Nasdaq-100, Dow Jones, Russell 2000, VIX, FTSE 100
- Docs: API reference: indices
- Learn: Market breadth indicators