# Exchange Trading Calendar – Real-Time Market Status

> Exchange Trading Calendar – Real-Time Market Status 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 current trading status (open, closed, lunch break, pre/after-hours) plus local time, next open, and next close in UTC for up to 28 global stock exchanges in a single call.

## Facts

- Endpoint: GET https://handelskalender-api.pages.dev/v1/market-status?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-real-time-market-status-4b62a7eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K0xn00BdkRY9VhsYUod5D

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-real-time-market-status-4b62a7eb
```

Example prompt: Are any of the major exchanges — NYSE, Nasdaq, LSE, and Tokyo — currently open for trading, and if not, when does each one open next? Give me their status right now.

## When to prefer this

Choose this endpoint when an agent needs an instant, real-time snapshot of whether one or more global stock exchanges are currently tradeable — especially when covering multiple exchanges in a single call. It is purpose-built for financial automation that must gate actions on market open/close state, and it covers 28 exchanges including all major global venues. Prefer it over generic calendar APIs or web scraping when you need authoritative, structured exchange status with UTC timestamps and holiday identification.

## Known failure modes

- HTTP 400 returned for unrecognized exchange MIC codes or names (no charge incurred)
- Stale or incorrect data if official exchange calendar has not been updated for a newly announced holiday
- Network timeout or service unavailability on the Cloudflare Pages host
- Malformed comma-separated exchange list causing partial or failed resolution

## How this service works

Use when an agent needs to know right now which stock exchanges are open: open, lunch break, pre-market, after-hours or closed (with holiday name), local time, exact next open and close in UTC. One call checks up to 28 exchanges (default all) incl. NYSE, Nasdaq, LSE, Xetra, Euronext, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; unknown exchange: HTTP 400, no charge.

## Output

A structured response per requested exchange containing: current trading session state (open, closed, lunch break, pre-market, after-hours), the exchange's local time, the holiday name if applicable, and the exact next open and close timestamps in UTC. Returns HTTP 400 for unrecognized exchange codes at no charge.

## 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",
     "properties": {
      "exchanges": {
       "type": "string",
       "description": "Comma-separated MIC codes or names, e.g. XNYS,XETR,XTKS. Optional, default: all 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-real-time-market-status-4b62a7eb/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)