Skip to main content

​
What it returns

  • market session status for supported exchanges
  • timezone and session hours
  • coverage metadata showing whether the calendar is weekend-only or holiday-configured
  • confidence and status notes so callers can see when a session is only tentatively inferred
  • source URL provenance for each market

​
Coverage model

  • configured_holidays means SEC API has an explicit holiday map and weekend rules for the exchange
  • weekend_only means SEC API currently knows the exchange weekend pattern and regular hours but may not yet reflect every local holiday closure
  • confidence=tentative is returned when SEC API is inferring an open session from weekend-only coverage
  • this surface is intentionally explicit about partiality so downstream tools do not silently treat all exchanges as equally hardened

​
Source inventory

  • XNYS: NYSE hours and holiday calendar
  • XNAS: Nasdaq holiday schedule
  • XLON: London Stock Exchange market hours
  • XTKS: Japan Exchange Group market calendar
  • XHKG: Hong Kong Exchanges trading hours
  • XTAE: Tel Aviv Stock Exchange trading hours
  • XSAU: Saudi Exchange trading hours

​
Rights and sync rules

  • public_source_documented means the exchange page and current usage posture have been reviewed and recorded in the source inventory
  • public_source_review_required means SEC API has the public source mapped, but local holiday coverage still needs explicit hardening before callers should assume full certainty
  • daily_midnight_local, daily_manual_review, and manual_review_only are source-review posture values exported from the checked-in market definitions
  • the current repo does not prove external sync jobs for every inventory row; the inventory artifacts are generated from in-repo source definitions

​
Sync posture

  • SEC API serves /v1/market/calendar from checked-in market definitions
  • coverage artifacts are derived from that checked-in source inventory
  • weekend-only exchanges are intentionally labeled as tentative on non-weekend weekdays until holiday coverage is hardened

​
Supported markets

  • XNYS
  • XNAS
  • XLON
  • XTKS
  • XHKG
  • XTAE
  • XSAU

​
What is safe to assume today

  • XNYS and XNAS are safe for production assumptions about holiday-aware session state
  • the other listed exchanges are useful, but should be treated as documented public-hour utilities rather than fully holiday-complete calendars
  • client applications and downstream agents should read coverage, confidence, and statusNote before making trade-window assumptions

​
Example