---
title: "Get Market Calendar"
method: GET
path: "/v2/calendar/{market}"
tags: ["Calendar"]
---

# Get Market Calendar

`GET /v2/calendar/{market}`

This endpoint returns the market calendar.

## 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).

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `timezone` 'UTC'

## Response `200`

OK

- PublicCalendarResp — Calendar response.
  - `calendar` CalendarDay[], required — The market calendar.
    - `core_end` string, date-time, required — The end time of the core market session.
    - `core_start` string, date-time, required — The start time of the core market session.
    - `date` string, date, required — The date of the calendar day.
    - `lunch_end` string, date-time — The end time of the lunch session.
    - `lunch_start` string, date-time — The start time of the lunch session.
    - `post_end` string, date-time — The end time of the after-hours session.
    - `post_start` string, date-time — The start time of the after-hours session.
    - `pre_end` string, date-time — The end time of the pre-market session.
    - `pre_start` string, date-time — The start time of the pre-market session.
    - `settlement_date` string, date — The settlement date.
  - `market` PublicMarket, required — A market.
    - `acronym` string, required — The acronym of the market.
    - `bic` string — Business Identifier Code (BIC/SWIFT).
    - `mic` string — Market identifier code (ISO 10383).
    - `name` string, required — The full name of the market.
    - `timezone` string, required — The timezone of the market.

## Other responses

- `400` — One of the request parameters is invalid. See the returned message for details.
- `429` — Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500` — Internal server error. We recommend retrying these later. If the issue persists, please contact us on [Slack](https://alpaca.markets/slack) or on the [Community Forum](https://forum.alpaca.markets/).

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)