# Market and Holiday Calendar

NYSE trading calendar, early closes, option expirations, trading days, and public holidays for 100 countries.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://market-calendar.x402tookit.com/openapi.json
- x402 manifest: https://market-calendar.x402tookit.com/.well-known/x402
- Catalog (free): https://market-calendar.x402tookit.com/catalog
- Health (free): https://market-calendar.x402tookit.com/health
- Uptime (free): https://market-calendar.x402tookit.com/uptime

## Endpoints (9)

### GET /is-holiday — $0.02
Is a date a public holiday in a country? Also whether it is a business day and the next holiday after it.
Params: country: string, date: string
Example: https://market-calendar.x402tookit.com/is-holiday?country=GB&date=2026-12-28

### GET /long-weekends — $0.02
Long weekends in a year for a country, with length in days and the bridge days that would extend them.
Params: country: string, year: integer
Example: https://market-calendar.x402tookit.com/long-weekends?country=US&year=2026

### GET /market-holidays-us — $0.02
NYSE market holidays and 1 PM early closes for a year, with the weekday of each, from the exchange's published rules.
Params: year: integer
Example: https://market-calendar.x402tookit.com/market-holidays-us?year=2026

### GET /market-status-us — $0.02
Is the US stock market (NYSE/Nasdaq) open right now or at a given time: session, hours, early close and the next open.
Params: at?: string
Example: https://market-calendar.x402tookit.com/market-status-us?at=2026-11-27T17%3A30%3A00Z

### GET /next-holidays — $0.02
The next upcoming public holidays in a country within the coming year, with days until each.
Params: country: string, limit?: integer
Example: https://market-calendar.x402tookit.com/next-holidays?country=GB&limit=5

### GET /next-trading-day — $0.02
The date N US trading days after (or before) a given date, skipping weekends and NYSE holidays, with the starting day's status.
Params: date: string, days?: integer
Example: https://market-calendar.x402tookit.com/next-trading-day?date=2026-07-02&days=1

### GET /options-expiry — $0.02
US monthly equity option expirations for a year: third Friday, moved to Thursday on a market holiday; flags triple witching.
Params: year: integer, month?: integer
Example: https://market-calendar.x402tookit.com/options-expiry?year=2026

### GET /public-holidays — $0.02
Public holidays for a country and year (about 100 countries), flagging regional-only holidays and weekday of each.
Params: country: string, year: integer
Example: https://market-calendar.x402tookit.com/public-holidays?country=DE&year=2026

### GET /trading-days-between — $0.02
Count US trading days between two dates (inclusive), with weekends and NYSE holidays removed and the holidays listed.
Params: from: string, to: string
Example: https://market-calendar.x402tookit.com/trading-days-between?from=2026-06-15&to=2026-07-10

## Terms

The US market calendar is computed from published NYSE holiday rules and cannot know unscheduled closures (such as national days of mourning or emergencies); verify with the exchange before relying on it for trading. Country holidays come from Nager.Date and may omit regional or recent changes. Not financial advice.