Every holiday of country in year, sorted by date: name in English (or language), the
local name, categories and whether an observance rule moved it. Add subdivision for state,
province or region holidays, and categories for bank, government, optional or religious days.
Parameters
yearpath · integerREQUIRED
Year, 1900–2100
countrypath · stringREQUIRED
ISO 3166-1 alpha-2 or alpha-3 code
subdivisionquery · string
Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them)
categoriesquery · string
Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`).
languagequery · string
Language for `name`, e.g. `en_US`, `de`, `fr`. Default: English when available.
observedquery · boolean
Include days off moved by observance rules (e.g. a Sunday holiday observed on Monday)
Responses
Successful Response
application/json
countrystring
ISO 3166-1 alpha-2 code
marketstring
ISO 10383 MIC
subdivisionstring
Subdivision code, when one was asked for
categoriesstring[]REQUIRED
languagestringREQUIRED
Language of `name`
calendar_versionstringREQUIRED
Version of the holiday rules used
yearintegerREQUIRED
countintegerREQUIRED
holidaysobject[]REQUIRED
Item fields
datedateREQUIRED
weekdaystringREQUIRED
English weekday name
namestringREQUIRED
Name in the requested language (English by default when available)
local_namestringREQUIRED
Name in the calendar's own language
categoriesstring[]REQUIRED
Categories this holiday belongs to
observedbooleanREQUIRED
True when an observance rule moved the day off here (e.g. a Saturday holiday observed on Monday)
Whether date is a holiday, a weekend day and a business day in one calendar, with the
holidays that fall on it. Official weekend workdays (such as China's swapped days) count as
business days.
Parameters
datequery · date
ISO date; default today (UTC)
countryquery · string
ISO 3166-1 alpha-2 or alpha-3 code, e.g. `US` or `DEU`. Give `country` or `market`.
marketquery · string
Exchange MIC or acronym, e.g. `XNYS` or `NYSE`. Give `country` or `market`.
subdivisionquery · string
Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them)
categoriesquery · string
Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`).
languagequery · string
Language for `name`, e.g. `en_US`, `de`, `fr`. Default: English when available.
weekendquery · string
Override the weekend: weekday names or abbreviations such as `sat,sun` or `fri,sat`, or `none`. Default: the calendar's own.
Responses
Successful Response
application/json
countrystring
ISO 3166-1 alpha-2 code
marketstring
ISO 10383 MIC
subdivisionstring
Subdivision code, when one was asked for
categoriesstring[]REQUIRED
languagestringREQUIRED
Language of `name`
calendar_versionstringREQUIRED
Version of the holiday rules used
datedateREQUIRED
weekdaystringREQUIRED
is_holidaybooleanREQUIRED
is_weekendbooleanREQUIRED
Falls on a weekend day of this calendar
is_business_daybooleanREQUIRED
holidaysobject[]REQUIRED
Item fields
datedateREQUIRED
weekdaystringREQUIRED
English weekday name
namestringREQUIRED
Name in the requested language (English by default when available)
local_namestringREQUIRED
Name in the calendar's own language
categoriesstring[]REQUIRED
Categories this holiday belongs to
observedbooleanREQUIRED
True when an observance rule moved the day off here (e.g. a Saturday holiday observed on Monday)
RapidAPI ● LiveApyHub ● Live · /v1/market-holidays/{year}/{market}
Days the exchange is closed in year (NYSE, NASDAQ, LSE, TARGET2, JPX, HKEX, NSE and more).
categories=half_day lists early closes instead of full closures.
Parameters
yearpath · integerREQUIRED
Year, 1900–2100
marketpath · stringREQUIRED
Exchange MIC or acronym
subdivisionquery · string
Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them)
categoriesquery · string
Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`).
languagequery · string
Language for `name`, e.g. `en_US`, `de`, `fr`. Default: English when available.
observedquery · boolean
Include days off moved by observance rules (e.g. a Sunday holiday observed on Monday)
Responses
Successful Response
application/json
countrystring
ISO 3166-1 alpha-2 code
marketstring
ISO 10383 MIC
subdivisionstring
Subdivision code, when one was asked for
categoriesstring[]REQUIRED
languagestringREQUIRED
Language of `name`
calendar_versionstringREQUIRED
Version of the holiday rules used
yearintegerREQUIRED
countintegerREQUIRED
holidaysobject[]REQUIRED
Item fields
datedateREQUIRED
weekdaystringREQUIRED
English weekday name
namestringREQUIRED
Name in the requested language (English by default when available)
local_namestringREQUIRED
Name in the calendar's own language
categoriesstring[]REQUIRED
Categories this holiday belongs to
observedbooleanREQUIRED
True when an observance rule moved the day off here (e.g. a Saturday holiday observed on Monday)
The business day days business days after start (before it when negative). start
itself is never counted; days=0 returns start when it is a business day, otherwise the
next one. Lists the holidays and closures passed over.
Parameters
daysquery · integerREQUIRED
Business days to add; negative subtracts (±2500)
startquery · date
ISO date; default today (UTC)
countryquery · string
ISO 3166-1 alpha-2 or alpha-3 code, e.g. `US` or `DEU`. Give `country` or `market`.
marketquery · string
Exchange MIC or acronym, e.g. `XNYS` or `NYSE`. Give `country` or `market`.
subdivisionquery · string
Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them)
categoriesquery · string
Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`).
weekendquery · string
Override the weekend: weekday names or abbreviations such as `sat,sun` or `fri,sat`, or `none`. Default: the calendar's own.
excludequery · string
Extra closed dates, comma-separated ISO dates (at most 366), e.g. company shutdown days
Responses
Successful Response
application/json
countrystring
ISO 3166-1 alpha-2 code
marketstring
ISO 10383 MIC
subdivisionstring
Subdivision code, when one was asked for
categoriesstring[]REQUIRED
languagestringREQUIRED
Language of `name`
calendar_versionstringREQUIRED
Version of the holiday rules used
startdateREQUIRED
daysintegerREQUIRED
Business days added (negative: subtracted)
datedateREQUIRED
The resulting business day
calendar_daysintegerREQUIRED
Calendar days between `start` and `date`
weekendstring[]REQUIRED
Weekend days used
skipped_holidaysobject[]REQUIRED
Holidays and closures passed over (weekends are not listed)
