Coverage
What you get
| Item | Detail |
|---|---|
| Product code | IDX-VALUES |
| Coverage | Major US and global stock indices, using plain codes such as SPX, NDX, DJI, RUT |
| Granularity | 1m up to 1d |
| History | Free: 1 year of end-of-day for about 20 major indices. Starter: full daily history. Pro: adds 1-minute history |
| Delivery | REST, CSV files per index |
| Update speed | End of day on Free; 15-minute delayed levels from Starter |
An index is a number, not something you can trade. That matters in two places. First, there's usually no real volume, so volume is only filled where the publisher provides one. Second, many free "S&P 500" series are really a CFD or an ETF price relabelled. Every row here has is_official, so you know whether you're looking at the index itself.
Schema
Schema
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Plain index code, e.g. SPX, NDX, DJI, RUT |
name |
string | yes | e.g. S&P 500 |
interval |
string | yes | 1m ... 1d |
timestamp / date |
string | yes | Intraday bar start (UTC) or session date |
open, high, low, close |
number | yes | Index points |
volume |
number | optional | Only where the provider publishes it |
previous_close |
number | optional | Prior session close |
change |
number | optional | Close minus previous close |
change_percent |
number | optional | Percent change |
currency |
string | optional | Index currency |
provider |
string | optional | Index owner, e.g. S&P Dow Jones Indices |
is_official |
boolean | yes | False for derived or CFD values, so buyers can tell them apart |
Example record:
{
"symbol": "SPX",
"name": "S&P 500",
"interval": "1d",
"date": "2026-11-18",
"open": 6702.14,
"high": 6741.88,
"low": 6688.30,
"close": 6725.42,
"previous_close": 6699.07,
"change": 26.35,
"change_percent": 0.3933,
"currency": "USD",
"provider": "S&P Dow Jones Indices",
"is_official": true
}
Sample data
Sample data
No free index sample yet. Even end-of-day index levels need a licence from the index owner before we can redistribute them, and we're checking those terms now. A sample file is available on request for the indices you need.
Use cases
Use cases
Benchmarking a strategy. Divide your equity curve by SPX close on the same date to see whether you beat the market or just rode it. Remember that price indices exclude dividends.
Regime filters. A simple rule like "only take longs when SPX closes above its 200-day average" needs nothing more than daily closes, and it's one of the most tested filters there is.
Intraday index behaviour. On Pro, 1-minute NDX bars let you study the first and last half hours of the cash session without the noise of the overnight futures market.
Relative strength between indices. RUT against SPX shows when small caps lead or lag large caps. Divide the two close series and chart the ratio.
Code
Code examples
Example: S&P 500 daily history.
curl "https://api.marketdata.co/v1/indices/values?symbol=SPX&interval=1d&start=2000-01-01" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: Python, small caps vs large caps ratio.
import os
import requests
import pandas as pd
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
closes = {}
for sym in ["SPX", "RUT"]:
r = requests.get(
"https://api.marketdata.co/v1/indices/values",
params={"symbol": sym, "interval": "1d", "start": "2015-01-01"},
headers=headers,
)
r.raise_for_status()
df = pd.DataFrame(r.json()["results"])
closes[sym] = df.set_index(pd.to_datetime(df["date"]))["close"]
both = pd.DataFrame(closes).dropna()
ratio = both["RUT"] / both["SPX"]
print(ratio.resample("ME").last().tail(12))
Pricing
Pricing
| Plan | Index levels |
|---|---|
| Free, $0 | End of day for about 20 major indices, 1 year |
| Starter, $29/mo | Full daily history, 15-minute delayed levels |
| Pro, $79/mo | Adds 1-minute bar history |
| Enterprise | Real-time S&P, Nasdaq and Cboe index values, priced on request |
Files are planned at $19 per index for full daily history, $49 per index for full 1-minute history, or $690 for 1-minute bars on every index we carry. Prices are early access and may change.
Among the vendors we studied, index data subscriptions cost $9.99 to $1,250 a month, and one-off files run $360 to $880.
Side by side
How we compare
23 of the 50 providers we studied sell index levels, the most of any index product. Many don't say whether a value is official. We label every row, list per-index file prices you can buy once, and put real-time values on Enterprise because the index owners' fees are higher than a $249 plan can carry. Better to say that up front than bury it.
FAQ
Frequently asked questions
Is this the official index or an ETF proxy?
Check is_official. It's true for values from the index owner and false for anything derived, such as a CFD-based level.
Do index levels include dividends?
No. Standard price indices like the S&P 500 exclude dividends. Total-return versions are separate indices, published under their own codes.
Why is volume empty?
Most indices don't have trading volume, because you can't trade the index itself. volume is filled only where the publisher provides a figure.
What time zone are intraday bars in?
UTC, stamped at the bar start. Daily bars use the session date.
Can I get real-time index values?
Only on Enterprise. S&P, Nasdaq and Cboe charge real-time fees that don't fit a self-serve plan, so Starter and Pro get 15-minute delayed levels.
Keep reading
Related
- Asset hub: Indices
- Indices: S&P 500, Nasdaq-100, Dow Jones, Russell 2000, VIX, FTSE 100
- Docs: API reference: indices
- Learn: What is OHLCV data