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

Data product · Early access

Market Breadth Data: Advance/Decline and New Highs

How many stocks are actually taking part in a move: advancers against decliners, up volume against down volume, new highs against new lows, plus intraday TICK and TRIN.

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