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
| Name | Required | Type | Description |
|---|---|---|---|
| date | Optional | string | Date 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
- 200
- 4XX
Response Body
{
"status": "success",
"data": [
{
"date": "2026-11-26",
"holiday_type": "TRADING_HOLIDAY"
},
{
"date": "2026-12-25",
"holiday_type": "TRADING_HOLIDAY"
}
]
}
| Name | Type | Description |
|---|---|---|
| status | string | Outcome of the request. Typically success. |
| data | object[] | US market holidays, sorted by date. Empty when the requested date is not a holiday. |
| data[].date | string | Holiday date, in YYYY-MM-DD format. |
| data[].holiday_type | string | Type of holiday, for example TRADING_HOLIDAY. |
Error codes
| Error code | Description |
|---|---|
| UDAPI1088 | Invalid date - The date must be in YYYY-MM-DD format. |
Sample Code
Get all US market holidays
- Python
- Node.js
- Java
- PHP
- Python SDK
- Node.js SDK
- Java SDK
- PHP SDK
- .NET SDK
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())
const axios = require('axios');
const url = 'https://api.upstox.com/v2/us/market/holidays';
const headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {your_access_token}',
};
axios.get(url, { headers })
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error.response ? error.response.data : error.message);
});
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.upstox.com/v2/us/market/holidays"))
.header("Accept", "application/json")
.header("Authorization", "Bearer {your_access_token}")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
<?php
$url = 'https://api.upstox.com/v2/us/market/holidays';
$headers = [
'Accept: application/json',
'Authorization: Bearer {your_access_token}',
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error: ' . curl_error($ch);
} else {
echo $response;
}
curl_close($ch);
?>
import upstox_client
from upstox_client.rest import ApiException
configuration = upstox_client.Configuration()
configuration.access_token = '{your_access_token}'
api_instance = upstox_client.UsMarketHolidaysAndTimingsApi(upstox_client.ApiClient(configuration))
try:
api_response = api_instance.get_us_holidays()
print(api_response)
except ApiException as e:
print("Exception when calling UsMarketHolidaysAndTimingsApi->get_us_holidays: %s\n" % e)
let UpstoxClient = require('upstox-js-sdk');
let defaultClient = UpstoxClient.ApiClient.instance;
var OAUTH2 = defaultClient.authentications['OAUTH2'];
OAUTH2.accessToken = "{your_access_token}";
let apiInstance = new UpstoxClient.USMarketHolidaysAndTimingsApi();
apiInstance.getUsHolidays((error, data, response) => {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + JSON.stringify(data));
}
});
import com.upstox.ApiClient;
import com.upstox.ApiException;
import com.upstox.Configuration;
import com.upstox.api.GetUsHolidayResponse;
import com.upstox.auth.OAuth;
import io.swagger.client.api.UsMarketHolidaysAndTimingsApi;
public class Main {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
OAUTH2.setAccessToken("{your_access_token}");
UsMarketHolidaysAndTimingsApi apiInstance = new UsMarketHolidaysAndTimingsApi();
try {
GetUsHolidayResponse result = apiInstance.getUsHolidays();
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling UsMarketHolidaysAndTimingsApi#getUsHolidays");
e.printStackTrace();
}
}
}
<?php
$config = (new Upstox\Client\Configuration())
->setAccessToken('{your_access_token}');
$apiInstance = new Upstox\Client\Api\USMarketHolidaysAndTimingsApi(
new GuzzleHttp\Client(),
$config
);
try {
$result = $apiInstance->getUsHolidays();
print_r($result);
} catch (Exception $e) {
echo 'Exception when calling USMarketHolidaysAndTimingsApi->getUsHolidays: ' . $e->getMessage();
}
using UpstoxClient.Api;
using UpstoxClient.Client;
using UpstoxClient.Extensions;
using UpstoxClient.Model;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
var host = Host.CreateDefaultBuilder()
.ConfigureApi((context, services, options) =>
{
options.AddTokens(new OAuthToken("{your_access_token}"));
}).Build();
await host.StartAsync();
var apiInstance = host.Services.GetRequiredService<IUSMarketHolidaysAndTimingsApi>();
try
{
var response = await apiInstance.GetUsHolidaysAsync();
Console.WriteLine(response.RawContent);
}
catch (Exception e)
{
Console.WriteLine("Exception: " + e.Message);
}
await host.StopAsync();
Check a specific date
- Python
- Node.js
- Java
- PHP
- Python SDK
- Node.js SDK
- Java SDK
- PHP SDK
- .NET SDK
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())
const axios = require('axios');
const url = 'https://api.upstox.com/v2/us/market/holidays/2026-11-26';
const headers = {
'Accept': 'application/json',
'Authorization': 'Bearer {your_access_token}',
};
axios.get(url, { headers })
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error.response ? error.response.data : error.message);
});
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.upstox.com/v2/us/market/holidays/2026-11-26"))
.header("Accept", "application/json")
.header("Authorization", "Bearer {your_access_token}")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
<?php
$url = 'https://api.upstox.com/v2/us/market/holidays/2026-11-26';
$headers = [
'Accept: application/json',
'Authorization: Bearer {your_access_token}',
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'Error: ' . curl_error($ch);
} else {
echo $response;
}
curl_close($ch);
?>
import upstox_client
from upstox_client.rest import ApiException
configuration = upstox_client.Configuration()
configuration.access_token = '{your_access_token}'
api_instance = upstox_client.UsMarketHolidaysAndTimingsApi(upstox_client.ApiClient(configuration))
try:
api_response = api_instance.get_us_holiday('2026-11-26')
print(api_response)
except ApiException as e:
print("Exception when calling UsMarketHolidaysAndTimingsApi->get_us_holiday: %s\n" % e)
let UpstoxClient = require('upstox-js-sdk');
let defaultClient = UpstoxClient.ApiClient.instance;
var OAUTH2 = defaultClient.authentications['OAUTH2'];
OAUTH2.accessToken = "{your_access_token}";
let apiInstance = new UpstoxClient.USMarketHolidaysAndTimingsApi();
apiInstance.getUsHoliday("2026-11-26", (error, data, response) => {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + JSON.stringify(data));
}
});
import com.upstox.ApiClient;
import com.upstox.ApiException;
import com.upstox.Configuration;
import com.upstox.api.GetUsHolidayResponse;
import com.upstox.auth.OAuth;
import io.swagger.client.api.UsMarketHolidaysAndTimingsApi;
public class Main {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
OAuth OAUTH2 = (OAuth) defaultClient.getAuthentication("OAUTH2");
OAUTH2.setAccessToken("{your_access_token}");
UsMarketHolidaysAndTimingsApi apiInstance = new UsMarketHolidaysAndTimingsApi();
String date = "2026-11-26";
try {
GetUsHolidayResponse result = apiInstance.getUsHoliday(date);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling UsMarketHolidaysAndTimingsApi#getUsHoliday");
e.printStackTrace();
}
}
}
<?php
$config = (new Upstox\Client\Configuration())
->setAccessToken('{your_access_token}');
$apiInstance = new Upstox\Client\Api\USMarketHolidaysAndTimingsApi(
new GuzzleHttp\Client(),
$config
);
try {
$result = $apiInstance->getUsHoliday('2026-11-26');
print_r($result);
} catch (Exception $e) {
echo 'Exception when calling USMarketHolidaysAndTimingsApi->getUsHoliday: ' . $e->getMessage();
}
using UpstoxClient.Api;
using UpstoxClient.Client;
using UpstoxClient.Extensions;
using UpstoxClient.Model;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
var host = Host.CreateDefaultBuilder()
.ConfigureApi((context, services, options) =>
{
options.AddTokens(new OAuthToken("{your_access_token}"));
}).Build();
await host.StartAsync();
var apiInstance = host.Services.GetRequiredService<IUSMarketHolidaysAndTimingsApi>();
try
{
var response = await apiInstance.GetUsHolidayAsync("2026-11-26");
Console.WriteLine(response.RawContent);
}
catch (Exception e)
{
Console.WriteLine("Exception: " + e.Message);
}
await host.StopAsync();