Sign in

v1

latestOpenAPI 3.0.02026-07-26166415635.8 KB
Calendar

Get US Market 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.

get/v1/calendar

Query parameters

startstring date-time

The first date to retrieve data for (inclusive).

endstring date-time

The last date to retrieve data for (inclusive).

date_type'TRADING' | 'SETTLEMENT'

Indicates what start and end mean. Default: TRADING. If TRADING is specified, returns a calendar whose trading date matches start, end. If SETTLEMENT is specified, returns the calendar whose settlement date matches start and end.

Response

OK

closestring required

The time the market closes at on this date in HH:MM format.

datestring date required

Date string in YYYY-MM-DD format.

openstring required

The time the market opens at on this date in HH:MM format.

session_closestring required

The time the session closes at on this date in HHMM format.

session_openstring required

The time the session opens at on this date in HHMM format.

settlement_datestring date required

Date string in YYYY-MM-DD format. Representing the settlement date for the trade date.

Example response

[
  {
    "close": "16:00",
    "date": "2025-01-02",
    "open": "09:30",
    "session_close": "2000",
    "session_open": "0400",
    "settlement_date": "2025-01-03"
  }
]