Skip to main content
GET 

/us/market/holidays/:date

Market Holidays

API to retrieve US market holidays. Without a date, it returns every US market holiday of the current year, sorted by date. With a date, it returns the holiday on that date, or an empty list when the date is not a holiday.

Path Parameters​

NameRequiredTypeDescription
dateOptionalstringDate to check, in YYYY-MM-DD format. Omit it to get all holidays of the current year.

Request​

curl --location 'https://api.upstox.com/v2/us/market/holidays' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {your_access_token}'

For samples in other languages, see the Sample Code section on this page.

Responses​

Response Body​

{
"status": "success",
"data": [
{
"date": "2026-11-26",
"holiday_type": "TRADING_HOLIDAY"
},
{
"date": "2026-12-25",
"holiday_type": "TRADING_HOLIDAY"
}
]
}
NameTypeDescription
statusstringOutcome of the request. Typically success.
dataobject[]US market holidays, sorted by date. Empty when the requested date is not a holiday.
data[].datestringHoliday date, in YYYY-MM-DD format.
data[].holiday_typestringType of holiday, for example TRADING_HOLIDAY.

Sample Code​

Get all US market holidays​

import requests

url = 'https://api.upstox.com/v2/us/market/holidays'
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {your_access_token}',
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

Check a specific date​

import requests

url = 'https://api.upstox.com/v2/us/market/holidays/2026-11-26'
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {your_access_token}',
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())