Skip to main content
GET
/
stocks
/
markets
/
holidays
Get Market Holidays
curl --request GET \
  --url https://api.tradewatch.io/stocks/markets/holidays \
  --header 'api-key: <api-key>'
[
  {
    "exchange": "<string>",
    "flag": "<string>",
    "mic": "<string>",
    "date": "<string>",
    "day_of_week": "<string>",
    "is_weekend": true,
    "is_business_day": true,
    "holiday_name": "Black Friday",
    "is_early_close": true,
    "open_time": "2024-11-29T09:30:00-05:00",
    "close_time": "2024-11-29T13:00:00-05:00"
  }
]

Authorizations

​
api-key
string
header
required

Authentication via API key header

Query Parameters

​
mic
string

Specify comma separated list of MIC codes for which market to show data for.

​
start
string<date>
required

Show holidays starting at this date.

​
end
string<date>
required

Show holidays until this date.

Response

Successful Response

​
exchange
string
required

Full name of the exchange

Example:

"New York Stock Exchange"

​
flag
string
required

Country flag emoji

Example:

"🇺🇸"

​
mic
string
required

Market Identifier Code (ISO 10383)

Example:

"XNYS"

​
date
string
required

Date of the holiday (YYYY-MM-DD)

Example:

"2024-11-29"

​
day_of_week
string
required

Day of the week

Example:

"Friday"

​
is_weekend
boolean
required

Whether the holiday falls on a weekend

Example:

false

​
is_business_day
boolean
required

Whether the day is a business day

Example:

true

​
holiday_name
string | null
required

Name of the holiday

Example:

"Black Friday"

​
is_early_close
boolean | null
required

Whether the market closes early on this day

Example:

true

​
open_time
string<date-time> | null
required

Opening time for the day

Example:

"2024-11-29T09:30:00-05:00"

​
close_time
string<date-time> | null
required

Closing time for the day

Example:

"2024-11-29T13:00:00-05:00"