Calendars and ids

A calendar is a set of days that aren’t business days (closures, early closes and weekend working days) plus a weekend. Every calendar has an id, used in the calendars parameter and in its page address.

Kind	Id looks like	Examples
exchange	The exchange’s MIC	XNYS (New York Stock Exchange), XLON, XASX, XSAU (Saudi Exchange)
settlement	The currency code	USD (Fedwire / FedACH), EUR (TARGET2), AUD (RITS), SAR (Saudi riyal)
bond	SIFMA- and the market	SIFMA-US, SIFMA-UK, SIFMA-JP
country	ISO country code, then region or category	US, AU-NSW, GB-SCT, JP:bank, CA:government

• A region follows a hyphen (AU-NSW). A category follows a colon (JP:bank is Japan’s bank holidays, CA:government its federal government holidays).
• Settlement calendars are built from base calendars with rules: USD follows the US federal holidays but stays open on the Friday before a Saturday holiday, as the Federal Reserve does. Each calendar’s page lists its base.
• Gulf exchanges are built the same way, from their country’s public holidays plus the exchange’s own notices: XSAU (Tadawul), XADS (ADX), XDFM (DFM), DSMD (Qatar Stock Exchange), XKUW (Boursa Kuwait), XBAH (Bahrain Bourse) and XMUS (Muscat Stock Exchange). The Gulf currencies are SAR, AED, QAR, KWD, BHD and OMR.
• Ids are case-sensitive in the API (JP:bank). On this site, page addresses are lower case and use a hyphen for the colon (/calendars/jp-bank/).

List them all, or one kind:

curl -H "Authorization: Bearer $FC_API_KEY" "https://api.financecalendarapi.com/v1/calendars?kind=exchange"

Or browse them on the calendars page.