# Halowerk Market Hours

> Halowerk Market Hours is a paid API for AI agents from markt.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns whether a regulated stock exchange's main session is currently open and when the next session starts, covering 10 major exchanges with holiday calendars for 2026–2027

## Facts

- Endpoint: POST https://markt.halowerk.com/hours
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-market-hours-4b73f8d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r-nxU-nPnJAR5whzsoHhV

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 halowerk-market-hours-4b73f8d6 -d '<json body>'
```

Example prompt: Is the main trading session on the NYSE (XNYS) currently open, and if not, when does the next main session start?

## When to prefer this

Use this endpoint when an AI agent needs to gate or schedule any action against a specific regulated equity exchange and must know the current session state before proceeding. It is preferable to generic market-hours databases because it covers DST transitions via IANA timezone resolution (not fixed UTC offsets), includes half-day schedules, and has holiday data for 2026–2027. Best suited for pre-trade checks on the 10 supported exchanges; do not use for crypto exchange hours or OTC market status.

## Known failure modes

- Unsupported exchange MIC code returns an error — only XETR, XFRA, XNYS, XNAS, XLON, XPAR, XAMS, XSWX, XTKS, XHKG are covered
- Queries for dates beyond 2027 holiday calendar may return incomplete holiday data
- Malformed or missing request body returns a 4xx error
- Network timeout or service unavailability returns a 5xx error

## How this service works

Answers the timing question an agent has before it schedules anything against a regulated exchange: is the main session running, and if not, when does it start. Covers XETR, XFRA, XNYS, XNAS, XLON, XPAR, XAMS, XSWX, XTKS and XHKG with pre trading, main session, post trading, half days and the holidays of 2026 and 2027. Time zones are resolved through IANA names and Intl at the queried instant, never through a fixed offset to UTC, because summer time starts and ends on different dates in the Euro

## Output

Returns the current session status (pre-trading, main session, post-trading, or closed), whether the day is a half-day or holiday, the exchange's IANA timezone, and the datetime of the next main session open — all resolved at the queried instant using dynamic timezone offsets rather than fixed UTC offsets.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mic": {
   "type": "string",
   "default": "XETR",
   "pattern": "^[A-Za-z]{4}$",
   "description": "Market Identifier Code of the exchange: XETR, XFRA, XNYS, XNAS, XLON, XPAR, XAMS, XSWX, XTKS or XHKG."
  },
  "timestamp": {
   "type": "string",
   "description": "Instant to evaluate, as an ISO 8601 string. Empty or absent means now."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-market-hours-4b73f8d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markt.halowerk.com](https://www.zero.xyz/host/markt.halowerk.com/llms.txt)