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

Data product · Early access

Index Constituents and Weights Data

Which stocks were in an index on any given date, when each one joined and when it left, so a backtest on "the S&P 500" uses the S&P 500 as it was, not as it is today.

Coverage

What you get

Item Detail
Product code IDX-CONSTITUENTS
Coverage Major US stock indices, starting with the S&P 500
Granularity One row per member per index, with start_date and end_date
History Current and historical membership on Pro
Delivery REST, CSV files
Update speed Daily

Weights are the part index owners guard most closely. We're being straight about it: membership is included on Pro, weights are not. They'll only come on Enterprise, and only once we've licensed them. The weight field exists in the schema so your code is ready, but it will be empty on self-serve plans.

Schema

Schema

Field Type Required Description
symbol string yes Index, e.g. SPX
date string yes Membership as of date
member_symbol string yes Stock ticker, e.g. AAPL
member_name string yes Company name
weight number optional Percent weight; licensed data
sector string optional GICS-style sector
isin, cusip, figi string optional Identifiers
start_date string yes Date added
end_date string optional Date removed; null if still a member
is_active boolean yes Current member

Example record:

{
  "symbol": "SPX",
  "date": "2026-11-18",
  "member_symbol": "NVDA",
  "member_name": "NVIDIA Corporation",
  "sector": "Information Technology",
  "isin": "US67066G1040",
  "start_date": "2001-11-30",
  "end_date": null,
  "is_active": true
}

Sample data

Sample data

There's no free constituents sample yet, as membership lists are subject to the index owner's review. A sample file is available on request for any index we cover.

Use cases

Use cases

Survivorship-free backtests. Test a strategy on today's S&P 500 members over 20 years and you've quietly excluded every company that shrank, got acquired or went bust. Use start_date and end_date to rebuild the index on each rebalance date and the backtest only trades what was actually in it.

Index addition trades. Stocks added to a major index often see heavy buying around the effective date as index funds rebalance. Filter for rows with a recent start_date and study the price action around it with our daily bars.

Sector exposure. Group current members by sector to see how concentrated an index is, then repeat it for past dates to see how the mix has shifted.

Universe definitions. Use is_active = true for a clean list of current members to feed a screener or a scanner, refreshed daily.

Code

Code examples

Example: S&P 500 members on a past date.

curl "https://api.marketdata.co/v1/indices/constituents?symbol=SPX&date=2015-06-30" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, full membership history and the members on any date.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/indices/constituents",
    params={"symbol": "SPX", "history": "true"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
m = pd.DataFrame(resp.json()["results"])
m["start_date"] = pd.to_datetime(m["start_date"])
m["end_date"] = pd.to_datetime(m["end_date"])

def members_on(day):
    day = pd.Timestamp(day)
    live = (m["start_date"] <= day) & (m["end_date"].isna() | (m["end_date"] > day))
    return sorted(m.loc[live, "member_symbol"])

print(len(members_on("2015-06-30")))

Pricing

Pricing

Plan Index constituents
Pro, $79/mo Current and historical membership, no weights
Enterprise Weights, once licensed from the index owner, priced on request

A file of historical S&P 500 membership is planned at $99 one-off. Prices are early access and may change.

Among the vendors we studied, constituent data costs $29.99 to $1,250 a month.

Side by side

How we compare

Only 5 of the 50 providers we studied sell index constituents, and some offer current members only. Historical membership is what backtesters need, and it carries less licence risk than weights, so that's what we put in Pro. The member_symbol uses the same tickers as our stock data, so you can pull bars for a past index in one loop.

FAQ

Frequently asked questions

Do you include companies that were removed?

Yes. Removed members keep their row with an end_date, which is the whole point of historical membership.

Are weights included?

Not on Pro. Index owners license weights separately, and we'll offer them on Enterprise once we have that licence.

What happens when a member changes its ticker?

The membership row follows the company. Use our splits and dividends data, which records symbol_change events, to map old tickers to new ones.

How often is membership updated?

Daily. Index changes are usually announced in advance, and the row appears with its effective start_date or end_date.

Which date should I use in a backtest?

The rebalance date you're simulating. Pick members where start_date is on or before it and end_date is empty or after it.

Keep reading