GET/us/market/timings/:date
Market Timings
API to retrieve the US market session times for a date. The response has the open and close times of the regular trading session. On a weekend or holiday, data is an empty list.
Path Parameters
| Name | Required | Type | Description |
|---|---|---|---|
| date | Required | string | Date to check, in YYYY-MM-DD format. |
Request
curl --location 'https://api.upstox.com/v2/us/market/timings/2026-10-22' \
--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": [
{
"exchange": "US_EQ",
"start_time": 1792762200000,
"end_time": 1792785600000
}
]
}
| Name | Type | Description |
|---|---|---|
| status | string | Outcome of the request. Typically success. |
| data | object[] | US market sessions on the date. Empty when the market is closed. |
| data[].exchange | string | Segment. Always US_EQ. |
| data[].start_time | number | Regular session open, as epoch milliseconds. |
| data[].end_time | number | Regular session close, as epoch milliseconds. |
Error codes
| Error code | Description |
|---|---|
| UDAPI1088 | Invalid date - The date must be in YYYY-MM-DD format. |
Sample Code
Get US market timings for a 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/timings/2026-10-22'
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/timings/2026-10-22';
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/timings/2026-10-22"))
.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/timings/2026-10-22';
$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_exchange_timings('2026-10-22')
print(api_response)
except ApiException as e:
print("Exception when calling UsMarketHolidaysAndTimingsApi->get_us_exchange_timings: %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.getUsExchangeTimings("2026-10-22", (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.GetUsExchangeTimingResponse;
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-10-22";
try {
GetUsExchangeTimingResponse result = apiInstance.getUsExchangeTimings(date);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling UsMarketHolidaysAndTimingsApi#getUsExchangeTimings");
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->getUsExchangeTimings('2026-10-22');
print_r($result);
} catch (Exception $e) {
echo 'Exception when calling USMarketHolidaysAndTimingsApi->getUsExchangeTimings: ' . $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.GetUsExchangeTimingsAsync("2026-10-22");
Console.WriteLine(response.RawContent);
}
catch (Exception e)
{
Console.WriteLine("Exception: " + e.Message);
}
await host.StopAsync();