How a date becomes an answer.
The calendar engine turns exchange notices into per-date records. This page describes source tiers, calendar derivation, night-session definitions and the limits of what the site asserts.
Available · Source published · Page generated
Source tiers
| Tier | Meaning |
|---|---|
| Official original | The exchange notice itself: HTML page or PDF retrieved from the exchange domain, saved with its SHA-256. Where an exchange refuses direct requests (DCE, CZCE), a server-side fetch engine retrieves it and the record says so. |
| Official index | The exchange’s own listing where the notice body could not be fetched directly (WAF or access limits); dates read from the exchange-domain search index. |
| Complete reproduction, cross-checked | Two independent full reproductions or tables of the same notice agree with each other. Currently used only for the DCE product trading-hours table; labelled on every page that depends on it. |
Source records identify their type, URL and source-check date. A discovery link alone is never evidence for a date.
From notice to calendar
- Annual notices and holiday-specific night notices provide the dates, applicable products and source links.
- Closure intervals, reopening dates, make-up weekends and pre-holiday evenings are recorded separately. Missing evidence remains unknown.
- Later exchange notices amend the affected fields and dates, retaining source links and revision history.
Night sessions: two dates, two questions
night_session describes the evening that starts on the selected civil date (Beijing time) and applies to eligible products only. incoming_night_session describes the overnight component that belongs to the selected trading date. The evening before a holiday has no night session; the evening of the first day back belongs to the next trading date. GFEX currently lists day sessions only; stock exchanges have no night session.
Provisional calendars
Before an exchange publishes its annual notice, a year may be shown as provisional: derived by a declared rule from a government holiday list, compared against a loaded year (every date must match). Provisional answers are labelled on every page, travel beside (never inside) the core API record, and are replaced when the exchange notice is reviewed. Half days, night sessions and weather arrangements stay unknown. HKEX 2027 (provisional) →
What is not asserted
- Unknown is null, never closed. A failed fetch or a missing notice does not change a date.
- No live session status, settlement calendar, HKEX derivatives or point-in-time history. Northbound and Southbound use their own trading-day calendars. Unloaded years show publication status without guessed dates.
- Overseas venues (SGX, CME, ICE) show representative product hours, not exchange-wide status.
Updates, corrections and citation
Annual notices and holiday-specific night notices are checked when issued; publication dates vary by exchange. Source-check dates accompany the source records. Corrections: data@marketsopen.today. Cite a page as “Markets Open, page title, URL, data_version, source_checked_at” — the same fields the API returns; each indexable page carries a ready-made citation line and a Markdown version (append .md to its path).