Coverage
What you get
| Item | Detail |
|---|---|
| Product code | STK-REFERENCE |
| Coverage | US-listed common stocks, ETFs, ADRs, preferreds, warrants, units and funds |
| Granularity | One record per symbol, plus one calendar record per exchange per day |
| History | Current list on every plan; point-in-time lists (what was listed on a past date) from Pro |
| Delivery | REST, plus a full ticker list as a CSV or JSON download |
| Update speed | Refreshed daily |
Reference data is boring until it's wrong. A ticker gets reused, a company changes its name, an ETF closes, and suddenly your daily job is pulling prices for the wrong security. This endpoint is the lookup table every other product of ours depends on, and we give it away because charging for it would only make your other code worse.
Schema
Schema
One record per symbol. Fields marked optional are filled where a reliable source exists; we'd rather send null than a guess.
| Field | Type | Required | Description |
|---|---|---|---|
symbol |
string | yes | Our ticker |
name |
string | yes | Company or fund name |
asset_type |
string | yes | common_stock, etf, adr, preferred, warrant, unit, fund |
exchange |
string | yes | Primary listing MIC (e.g. XNYS) |
currency |
string | yes | Trading currency |
country |
string | yes | ISO 3166 country of listing |
is_active |
boolean | yes | Currently trading |
list_date |
string | optional | First trading date (ipoDate, startDate) |
delist_date |
string | optional | Last trading date if delisted |
figi |
string | optional | OpenFIGI |
share_class_figi |
string | optional | Share-class FIGI |
isin |
string | optional | ISIN |
cik |
string | optional | SEC Central Index Key |
cusip |
string | optional | Enterprise only; needs a CUSIP licence |
sector |
string | optional | Sector |
industry |
string | optional | Industry |
sic_code |
string | optional | SEC SIC code |
employees |
number | optional | Full-time employees |
website |
string | optional | Company site |
description |
string | optional | Business description |
logo_url |
string | optional | Company logo image |
The market calendar is a separate record: exchange, date, status (open, closed, early_close), open_time, close_time (ISO 8601 UTC) and holiday_name.
Example record:
{
"symbol": "MSFT",
"name": "Microsoft Corporation",
"asset_type": "common_stock",
"exchange": "XNAS",
"currency": "USD",
"country": "US",
"is_active": true,
"list_date": "1986-03-13",
"delist_date": null,
"figi": "BBG000BPH459",
"share_class_figi": "BBG001S5TD05",
"isin": "US5949181045",
"cik": "0000789019",
"sector": "Technology",
"industry": "Software - Infrastructure",
"sic_code": "7372",
"employees": 228000,
"website": "https://www.microsoft.com",
"logo_url": "https://cdn.marketdata.co/logos/MSFT.png"
}
Sample data
Sample data
A free sample of this file isn't posted yet. The full ticker list is planned as a free daily download, and until then a sample file is available on request.
Use cases
Use cases
Building a clean universe. Filter on asset_type = common_stock, country = US and is_active = true and you have a tradable stock universe without warrants, units and preferreds sneaking into your scanner.
Joining price data to filings. cik links a ticker to its SEC filings, and figi or isin link it to data from brokers and other vendors. Ticker alone is a weak join key, because tickers change and get reused.
Skipping holidays in a scheduler. Read the calendar for XNYS and only run your end-of-day job on days with status = open. On early_close days, close_time tells you when to run it instead.
Sector screens. sector, industry and sic_code let you group names for relative strength or rotation studies without paying for a separate classification feed.
Catching delistings. Compare today's list with yesterday's. Symbols that flip is_active to false and gain a delist_date are the ones to remove from watchlists and open-order checks.
Code
Code examples
Example: all active US common stocks.
curl "https://api.marketdata.co/v1/reference/tickers?asset_type=common_stock&is_active=true&limit=1000" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Example: load the list into pandas and count names per exchange.
import os
import requests
import pandas as pd
url = "https://api.marketdata.co/v1/reference/tickers"
headers = {"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"}
params = {"asset_type": "common_stock", "is_active": "true", "limit": 1000}
rows = []
while url:
resp = requests.get(url, params=params, headers=headers)
resp.raise_for_status()
body = resp.json()
rows.extend(body["results"])
url, params = body.get("next_url"), None
tickers = pd.DataFrame(rows)
print(tickers.groupby("exchange")["symbol"].count())
Example: the trading calendar for the rest of the year.
curl "https://api.marketdata.co/v1/reference/calendar?exchange=XNYS&start=2026-11-19&end=2026-12-31" \
-H "Authorization: Bearer $MARKETDATA_API_KEY"
Pricing
Pricing
| Plan | Ticker list and reference data |
|---|---|
| Free, $0 | Current ticker list, profiles, market calendar and status |
| Starter, $29/mo | Same, with higher rate limits |
| Pro, $79/mo | Adds point-in-time history: what was listed on any past date |
| Enterprise | CUSIP, which needs a separate licence |
The full ticker list is planned as a free CSV and JSON download, refreshed daily. For context, 13 of the providers we studied give basic reference data away. Where it's paid only, published prices run from $22.50 to $108.15 a month, based on 4 prices.
Side by side
How we compare
23 of the 50 providers we studied sell reference data, and most of them give the basics away, so there's no point pretending a ticker list is special. What we can do is make it consistent. The same symbol you get here is the key in our bars, trades, fundamentals and corporate actions, the identifiers (figi, isin, cik) are on the record instead of behind a second call, and point-in-time history means a backtest can ask what existed on a past date instead of only what exists today.
FAQ
Frequently asked questions
How many tickers does the list cover?
It's planned to cover every US-listed common stock, ETF, ADR, preferred, warrant, unit and fund we carry prices for. We'll publish the exact count with the first free download rather than quote a number now.
Does it include delisted stocks?
The current list includes them with is_active = false and a delist_date. Full price history for delisted names is part of our survivorship-bias-free data.
What time zone does the market calendar use?
open_time and close_time are ISO 8601 UTC, so a normal NYSE session shows as 14:30 to 21:00 in winter and 13:30 to 20:00 in summer. The date itself is the exchange's local trading date.
Is reference data real-time?
No, and it doesn't need to be. The list is refreshed daily; for intraday trading status such as halts, use the trading halts API.
Can I get the ticker list as a CSV?
Yes. The full list is planned as a free CSV and JSON download, with the same column names as the API.
Why is CUSIP Enterprise only?
CUSIP identifiers are licensed by their owner, so we can only include them under a licence that covers your use. FIGI and ISIN are free alternatives for most joins.
Keep reading
Related
- Asset hub: Stocks
- Symbols: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: tickers, exchanges and market calendar, Symbol formats
- Learn: How to choose a market data provider