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 the calendar
GET /v2/calendar
Returns the market calendar.
Parameters
Query Parameters
Attribute | Type | Requirement | Description |
---|---|---|---|
start |
timestamp | Optional |
The first date to retrieve data for (inclusive) |
end |
timestamp | Optional |
The last date to retrieve data for (inclusive) |
date_type |
string | Optional |
Indicates what start and end mean. Enum: ‘TRADING’ or ‘SETTLEMENT’. Default value is ‘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
An array of Calendar objectCalendar Entity #
Example #
{
"date": "2018-01-03",
"open": "09:30",
"close": "16:00"
"settlement_date": "2018-01-05"
}
Properties #
Attribute | Type | Description |
---|---|---|
date |
string | Date string in “%Y-%m-%d” format |
open |
string | The time the market opens at on this date in “%H:%M” format |
close |
string | The time the market closes at on this date in “%H:%M” format |
settlement_date |
string | Date string in “%Y-%m-%d” format. representing the settlement date for the trade date. |