public endpoint
NYSE session
One URL, one JSON response. Call it from any software: the market status is computed server side, in the exchange own timezone.
loading
UTC
New York
Local
Endpoint
GET https://trading.dijmedia.com/api/nyse-session
| Parameter | Value | Effect |
|---|---|---|
pretty |
1 |
Indents the response so it reads well in a browser. The data is identical. |
tz |
Europe/Paris |
Timezone used for the local clock and for session.open / session.close.
Any IANA identifier works. Defaults to Europe/Paris. |
at |
2026-03-16T14:00:00Z |
Answers for that moment instead of now — useful to check a holiday or a
daylight-saving gap ahead of time. The response carries
simulated: true, so no software mistakes it for the live state.
Works on this page too: add it to the address and the banner shows that day. |
Live response
GET /api/nyse-session
loading
Loading the endpoint...
What the response guarantees
| Field | Meaning |
|---|---|
status |
open, closed, weekend or holiday. |
is_open |
The single boolean most software needs. |
is_early_close |
True on half sessions, which close at 13:00 New York time instead of 16:00. |
holiday |
Name, date and type of the closure when the day is a holiday or a half session. |
next_event |
Next open or close, with in_seconds, in_minutes and an absolute UTC
timestamp. When the market is shut, reason says why. |
next_open / next_close |
Absolute ISO 8601 timestamps in UTC, so no client-side timezone maths is ever needed. |
upcoming_holidays |
The next five closures and half sessions, for software that plans ahead. |
dst_period |
summer, winter, or transition during the weeks when the
US and Europe have not switched on the same date. |
Holidays follow the NYSE rules, including observation: a holiday falling on a Saturday is observed the Friday before, one falling on a Sunday the Monday after, and a New Year Day landing on a Saturday closes nothing at all. Good Friday is derived from the date of Easter. Half sessions cover the day after Thanksgiving, Christmas Eve and the eve of Independence Day whenever they fall on a trading day.