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

# Get Market Calendar

`GET /v2/calendar/{market}`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v2/calendar/{market}`
- Auth: HTTP basic

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
- `end` string, date
- `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 or on the Community Forum.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)