Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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 OMNI has an explicit holiday map and weekend rules for the exchange
  • weekend_only means OMNI currently knows the exchange weekend pattern and regular hours but may not yet reflect every local holiday closure
  • confidence=tentative is returned when OMNI 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 OMNI 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

  • Datastream serves /v1/market/calendar from checked-in market definitions in services/datastream-api/src/lib/market-calendar.ts
  • ops artifacts are exported from that checked-in source inventory with bun run ops:market-calendar-inventory and bun run ops:market-calendar-sources
  • 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
  • omni-apps and downstream agents should read coverage, confidence, and statusNote before making trade-window assumptions

​
Example

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