Skip to main content

​
Market Calendar

​
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 knows the exchange weekend pattern and regular hours but may not reflect every local holiday closure
  • confidence=tentative is returned when SEC API is inferring an open session from weekend-only coverage
  • this API returns coverage and confidence fields so applications do not silently treat all exchanges as equally complete

​
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 state 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 review before callers should assume full certainty
  • daily_midnight_local, daily_manual_review, and manual_review_only are source-review status values exported from the source market definitions
  • SEC API does not currently expose external sync status for every inventory row

​
Sync Status

  • SEC API serves /v1/market/calendar from reviewed market definitions
  • coverage metadata is generated from the same source inventory used by the API
  • weekend-only exchanges are intentionally labeled as tentative on non-weekend weekdays until holiday coverage is complete

​
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
  • SEC API applications and downstream agents should read coverage, confidence, and statusNote before making trade-window assumptions

​
Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/calendar?market=XNYS&duration=5"