---
title: "Get US Market Calendar"
method: GET
path: "/v1/calendar"
tags: ["Calendar"]
---

# Get US Market Calendar

`GET /v1/calendar`

The calendar API serves the full list of market days from 1970 to 2029. It can also be queried by specifying a start and/or end time to narrow down the results. In addition to the dates, the response also contains the specific open and close times for the market days, taking into account early closures.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `date_type` 'TRADING' | 'SETTLEMENT'

## Response `200`

OK

- LegacyCalendarDay[]
  - `close` string, required — The time the market closes at on this date in HH:MM format.
  - `date` string, date, required — Date string in YYYY-MM-DD format.
  - `open` string, required — The time the market opens at on this date in HH:MM format.
  - `session_close` string, required — The time the session closes at on this date in HHMM format.
  - `session_open` string, required — The time the session opens at on this date in HHMM format.
  - `settlement_date` string, date, required — Date string in YYYY-MM-DD format. Representing the settlement date for the trade date.

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