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
Related
- Asset hub: Indices
- Indices: S&P 500, Nasdaq-100, Dow Jones, Russell 2000, VIX, FTSE 100
- Docs: API reference: indices
- Learn: Survivorship bias explained