API Reference: Tickers, Exchanges and Market Calendar
Details
Docs navigation
- Getting started: Quickstart, Authentication, Rate limits, Errors and retries
- Guides: Symbol formats, Timestamps and time zones, Pagination, Split and dividend adjustments, WebSocket streaming, Dataset downloads, Excel and Google Sheets, Changelog
- API reference: Stock bars, Stock trades and quotes, Snapshots and movers, Tickers, exchanges, calendar (you are here), Splits and dividends, Fundamentals and SEC filings, Options chain and Greeks, Options EOD, bars, OI, Forex, Crypto, Crypto derivatives, Futures bars and continuous, Settlements and COT, Indices, Economic data, Technical indicators
- SDKs: Python, JavaScript
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
figiorcikas a permanent key. Tickers get recycled after delistings. cusipis not returned; it needs a separate licence and is Enterprise only.- Delisted stocks are excluded by default. Pass
is_active=falsefor a survivorship-bias-free universe. - Calendar times are UTC. A 9:30 New York open shows as
14:30Zor13:30Zdepending 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.