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.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/alpaca/json-schema/alpaca-calendar-schema.json",
"title": "Calendar",
"description": "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.",
"x-generated": "2026-11-05",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/alpaca-calendar-api-openapi.yml#/components/schemas/Calendar",
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "Date string in YYYY-MM-DD format"
},
"open": {
"type": "string",
"description": "The time the market opens at on this date in HH:MM format"
},
"close": {
"type": "string",
"description": "The time the market closes at on this date in HH:MM format"
},
"session_open": {
"type": "string",
"deprecated": true,
"description": "this field has been deprecated please ignore"
},
"session_close": {
"type": "string",
"deprecated": true,
"description": "this field has been deprecated please ignore"
}
},
"required": [
"date",
"open",
"close"
]
}
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.