> ## 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

> Check market session status, hours, and holiday coverage for supported exchanges, with explicit confidence and partial-state semantics for each market.

## 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

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