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

Data product · Early access

Stock Ticker List and Reference Data API

The master list of what trades in the US, with identifiers, listing dates and the exchange calendar, so your code knows which symbols exist and when the market is open.

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