List markets

GET/api/v2/markets

Every market with its id, MIC, time zone, type, country and data coverage

One request: list. A successful response counts as one request

Example

curl https://marketcalendars.com/api/v2/markets \
  -H "Authorization: Bearer mc_live_..."

const res = await fetch("https://marketcalendars.com/api/v2/markets", {
  headers: { Authorization: `Bearer ${process.env.MARKETCALENDARS_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://marketcalendars.com/api/v2/markets",
    headers={"Authorization": f"Bearer {os.environ['MARKETCALENDARS_KEY']}"},
)
data = res.json()

GET /api/v2/markets200

{
  "count": 92,
  "markets": [
    {
      "id": "nyse",
      "name": "New York Stock Exchange",
      "shortName": "NYSE",
      "mic": "XNYS",
      "type": "stocks",
      "country": "United States",
      "countryCode": "US",
      "city": "New York",
      "region": "americas",
      "timezone": "America/New_York",
      "parent": null,
      "coverage": {
        "from": "1995-01-01",
        "to": "2051-12-31"
      },
      "url": "https://marketcalendars.com/markets/nyse"
    },
    {
      "id": "nasdaq",
      "name": "Nasdaq Stock Market",
      "shortName": "Nasdaq",
      "mic": "XNAS",
      "type": "stocks",
      "country": "United States",
      "countryCode": "US",
      "city": "New York",
      "region": "americas",
      "timezone": "America/New_York",
      "parent": null,
      "coverage": {
        "from": "1995-01-01",
        "to": "2051-12-31"
      },
      "url": "https://marketcalendars.com/markets/nasdaq"
    },
    {
      "id": "iex",
      "name": "Investors Exchange",
      "shortName": "IEX",
      "mic": "IEXG",
      "type": "stocks",
      "country": "United States",
      "countryCode": "US",
      "city": "New York",
      "region": "americas",
      "timezone": "America/New_York",
      "parent": null,
      "coverage": {
        "from": "2013-08-26",
        "to": "2051-12-31"
      },
      "url": "https://marketcalendars.com/markets/iex"
    }
  ]
}

A live response from the API. Lists longer than seven items are cut to three here

Response fields

MarketList object. Fields marked | null are always present and may be null

Field	Type	Description
count	integer	Number of markets
markets	object[]	Every market, in the order of the site's market list
markets[].id	string	Market id used in every path
markets[].name	string	Full name
markets[].shortName	string	Short name or abbreviation
markets[].mic	string \| null	ISO 10383 market identifier code
markets[].type	string	What the market trades`stocksfuturesoptionsbondsfxcrypto`
markets[].country	string	Country name
markets[].countryCode	string \| null	ISO 3166-1 alpha-2
markets[].city	string	City of the exchange
markets[].region	string	Region, as on /regions`americaseuropeasia-pacificmiddle-east-africa`
markets[].timezone	string	IANA time zone
markets[].parent	string \| null	Id of the primary market this is a sub-market of, such as cme for its product groups
markets[].coverage	object	Dates we have data for
markets[].coverage.from	string (date)	First date with data
markets[].coverage.to	string (date)	Last date with data
markets[].url	string (uri)	Market page on marketcalendars.com

Errors

401unauthorizedThe Authorization header is missing, malformed, or names a revoked key
429rate-limitedThe key sent more requests in a minute than its plan's burst limit
429quota-exceededThe plan's requests for this period are used up