Sign in

v1

latestOpenAPI 3.0.02026-07-26166415635.8 KB
Calendar

Get Market Calendar

This endpoint returns the market calendar.

get/v2/calendar/{market}

Path parameters

market'BMO' | 'BNYM' | 'BOATS' | 'CEUX' | 'CHIX' | 'HKEX' | 'IEX' | 'IEXG' | 'ISE' | 'LSE' | 'MTA' | 'MTAA' | 'NASDAQ' | 'NYSE' | 'OCEA' | 'OPRA' | 'OTC' | 'OTCM' | 'SIFMA' | 'TADAWUL' | 'XAMS' | 'XBRU' | 'XDUB' | 'XETR' | 'XETRA' | 'XHKG' | 'XLIS' | 'XLON' | 'XNAS' | 'XNYS' | 'XPAR' | 'XSAU' required

The market identifier (MIC, BIC, or acronym).

The market identifier. MIC, BIC, or acronym.

Available market codes by region:

United States

  • BMO: Bank of Montreal. US banking calendar (US operations).
  • BNYM: The Bank of New York Mellon. US banking calendar.
  • BOATS: Blue Ocean Alternative Trading System. US overnight trading.
  • IEX: Investors Exchange. US equities.
  • IEXG: Investors Exchange. US equities.
  • NASDAQ: National Association of Securities Dealers Automated Quotations. US equities.
  • NYSE: New York Stock Exchange. US equities.
  • OCEA: BlueOcean ATS. US overnight trading.
  • OPRA: Options Price Reporting Authority. US options.
  • OTC: Over-The-Counter. US OTC equities.
  • OTCM: OTC Markets. US OTC equities.
  • SIFMA: Securities Industry and Financial Markets Association. US bonds.
  • XNAS: NASDAQ. US equities.
  • XNYS: New York Stock Exchange. US equities.

Europe

  • CEUX: Cboe CEUX Europe. European equities (Cboe Netherlands).
  • CHIX: Cboe CHIX Europe. European equities (Cboe UK).
  • ISE: Euronext Dublin. Irish equities.
  • LSE: London Stock Exchange. UK equities.
  • MTA: Euronext Milan. Italian equities.
  • MTAA: Euronext Milan. Italian equities.
  • XAMS: Euronext Amsterdam. Dutch equities.
  • XBRU: Euronext Brussels. Belgian equities.
  • XDUB: Euronext Dublin. Irish equities.
  • XETR: Frankfurt Stock Exchange. German equities.
  • XETRA: Frankfurt Stock Exchange. German equities.
  • XLIS: Euronext Lisbon. Portuguese equities.
  • XLON: London Stock Exchange. UK equities.
  • XPAR: Euronext Paris. French equities.

Asia & Middle East

  • HKEX: Hong Kong Stock Exchange. Hong Kong equities.
  • JPX: Japan Exchange Group. Japanese equities.
  • TADAWUL: Saudi Stock Exchange. Saudi equities.
  • XHKG: Hong Kong Stock Exchange. Hong Kong equities.
  • XSAU: Saudi Stock Exchange. Saudi equities.
  • XTKS: Japan Exchange Group. Japanese equities.

Query parameters

startstring date-time

The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD. Default: the beginning of the current day, but at least 15 minutes ago if the user doesn't have real-time access for the feed.

endstring date-time

The inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD. Default: the current time if the user has a real-time access for the feed, otherwise 15 minutes before the current time.

timezone'UTC'

Timezone of the times. Default: the timezone of the market.

Response

OK

Example response

{
  "calendar": [
    {
      "core_end": "2025-01-02T16:00:00-05:00",
      "core_start": "2025-01-02T09:30:00-05:00",
      "date": "2025-01-02",
      "post_end": "2025-01-02T20:00:00-05:00",
      "post_start": "2025-01-02T16:00:00-05:00",
      "pre_end": "2025-01-02T09:30:00-05:00",
      "pre_start": "2025-01-02T04:00:00-05:00",
      "settlement_date": "2025-01-03"
    }
  ],
  "market": {
    "acronym": "NYSE",
    "bic": "IRVTUS3NXXX",
    "mic": "XNYS",
    "name": "New York Stock Exchange",
    "timezone": "America/New_York"
  }
}