# Exchange Trading Calendar — Full-Year Schedule

> Exchange Trading Calendar — Full-Year Schedule is a paid API for AI agents from handelskalender-api.pages.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-14).

Returns the complete annual trading calendar for a specified stock exchange, including all holidays, half-days, late openings, regular hours, and total trading-day count.

## Facts

- Endpoint: GET https://handelskalender-api.pages.dev/v1/trading-calendar?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/exchange-trading-calendar-full-year-schedule-aaf83412
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fK8T4jvj41vXm1EHsoDvm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability exchange-trading-calendar-full-year-schedule-aaf83412
```

Example prompt: Can you pull the full 2026 trading calendar for the NYSE — every holiday, half-day, and closure, plus the total number of trading days?

## When to prefer this

Use this endpoint when you need the complete annual view of a stock exchange's schedule — all closures, half-days, and trading-day counts for a full year — rather than checking a single date or the current live status. Ideal for pre-trade planning, backtesting pipelines, compliance calendars, and scheduling workflows that must account for every market closure across the year. Covers 28 major exchanges including NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, and ASX using official exchange calendars.

## Known failure modes

- HTTP 400 if exchange code or name is not among the 28 supported exchanges
- HTTP 400 if the requested year is outside the supported range
- Malformed exchange MIC code returns 400 with no charge
- Network timeout on Cloudflare Pages edge — retry recommended
- Missing required 'exchange' query parameter returns 400

## How this service works

Use when an agent plans ahead and needs every closure of a stock exchange for a whole year: holiday names, half days, late openings, regular hours, count of trading days. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; bad input or uncovered year: HTTP 400, no charge.

## Output

A structured annual calendar for the requested exchange, including: named holidays with dates, half-day sessions, late openings, standard daily trading hours, and a count of total trading days in the year. HTTP 400 is returned for unsupported exchanges or out-of-range years, with no charge applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "exchange"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Year, e.g. 2026. Optional, default: current year."
      },
      "exchange": {
       "type": "string",
       "description": "Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/exchange-trading-calendar-full-year-schedule-aaf83412/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from handelskalender-api.pages.dev](https://www.zero.xyz/host/handelskalender-api.pages.dev/llms.txt)