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

API Reference: Tickers, Exchanges and Market Calendar

Details

Docs navigation

Reference data is the layer every other call depends on: which symbols exist, what they are, where they list, and when the market is open. This page documents the ticker list endpoint, the single-company profile, the exchange list, market status and the trading calendar. It is free on every plan, and you will probably call it before anything else.

Early access. Planned v1 endpoints, not live yet. Free on every plan, including the calendar. Point-in-time listings (what was listed on a past date) need Pro ($79/mo). Option contract and futures contract lists live on their own pages: options chain and futures.

Details

Ticker list

GET https://api.marketdata.co/v1/reference/tickers

Parameters

Name Type Required Default Description
symbol string no Return one ticker's full profile
search string no Match on symbol or name, e.g. micro
asset_type string no all common_stock, etf, adr, preferred, warrant, unit, fund
exchange string no all Listing MIC, e.g. XNYS, XNAS
is_active boolean no true false returns delisted names too
as_of string no today Date for point-in-time listing (Pro)
limit integer no 1,000 Max 10,000
cursor, format string no Paging, json or csv

Response fields

Field Type Description
symbol string Ticker
name string Company or fund name
asset_type string See values above
exchange string Primary listing MIC
currency string Trading currency
country string ISO 3166 country of listing
is_active boolean Currently trading
list_date string First trading date (optional)
delist_date string Last trading date if delisted (optional)
figi, share_class_figi string OpenFIGI identifiers (optional)
isin string ISIN (optional)
cik string SEC Central Index Key (optional)
sector, industry string Classification (optional)
sic_code string SEC SIC code (optional)
employees number Full-time employees (optional)
website, description, logo_url string Profile fields (optional)

Example

Example (curl), all active common stocks:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.marketdata.co/v1/reference/tickers?asset_type=common_stock&is_active=true&limit=1000"

Example response for symbol=MSFT:

{
  "status": "ok",
  "count": 1,
  "next_cursor": null,
  "results": [
    {
      "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",
      "isin": "US5949181045",
      "cik": "0000789019",
      "sector": "Technology",
      "sic_code": "7372"
    }
  ]
}

Details

Exchanges

GET https://api.marketdata.co/v1/reference/exchanges returns mic, name, country, timezone and asset_classes for every venue we carry. No parameters.

Markets

Market status

GET https://api.marketdata.co/v1/reference/market-status returns whether each market is open right now.

Field Type Description
exchange string MIC or market code
status string open, closed, pre, post, early_close
next_open, next_close string ISO 8601 UTC

Markets

Market calendar

GET https://api.marketdata.co/v1/reference/calendar

Name Type Required Default Description
exchange string no XNYS Exchange MIC
start, end string no this year Date range

Each row has exchange, date, status (open, closed, early_close), open_time, close_time (UTC) and holiday_name.

Example (Python), list holidays and early closes for the rest of the year:

import os
import requests

r = requests.get(
    "https://api.marketdata.co/v1/reference/calendar",
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
    params={"exchange": "XNYS", "start": "2026-11-19", "end": "2026-12-31"},
)
for day in r.json()["results"]:
    if day["status"] != "open":
        print(day["date"], day["status"], day.get("holiday_name"))

API

Errors for these endpoints

HTTP error.code When
400 invalid_parameter Unknown asset_type or exchange MIC
403 plan_required as_of used below Pro
404 symbol_not_found symbol never existed in our data

Watch out

Notes and gotchas

  • Use figi or cik as a permanent key. Tickers get recycled after delistings.
  • cusip is not returned; it needs a separate licence and is Enterprise only.
  • Delisted stocks are excluded by default. Pass is_active=false for a survivorship-bias-free universe.
  • Calendar times are UTC. A 9:30 New York open shows as 14:30Z or 13:30Z depending on daylight saving.
  • The calendar is published ahead for the current and next year as exchanges announce holidays.
  • A full ticker download is also offered as a free CSV, refreshed daily.

Keep reading

Next steps

Details

Was this page useful?

[Yes] [No]

Missing an identifier or an exchange? Tell us on the custom data form.