# HALOWERK Market Hours Checker

> HALOWERK Market Hours Checker is a paid API for AI agents from handel.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-17).

Checks whether a given UTC timestamp falls within caller-supplied trading sessions (by weekday, start/end time, and optional closed dates) and returns a boolean market-open result

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/rechner/market-hours?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-market-hours-checker-225e3a95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g_YnIeCIC46wIWAITtp8Z

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-checker-225e3a95 -d '<json body>'
```

Example prompt: Check if the market is open right now — it's 2025-06-10T14:32:00Z, my timezone is Europe/Berlin, and my trading sessions are Monday through Friday from 09:00 to 17:30 local time, with 2025-06-09 as a closed date.

## When to prefer this

Use this endpoint when you need a lightweight, stateless check of whether a given moment falls within a caller-defined trading session schedule — especially when you already hold the session definitions and just need the open/closed computation. Prefer this over building your own time-zone-aware weekday logic, and over any broker API that bundles market-hours data with execution risk. Ideal for pre-trade guards, scheduling agents, and backtesting pipelines where you supply all session parameters yourself.

## Known failure modes

- Missing or malformed time_utc results in a validation error
- Invalid timezone string causes a parsing failure
- Session with start >= end (non-midnight crossing) interpreted as invalid range
- Closed dates array exceeds 1000 entries — rejected
- Weekday integer outside 0–6 range returns schema error
- Empty sessions array always returns market closed

## How this service works

Handelszeit gegen gelieferten Zeitplan prüfen. Wochentag 0=Montag; Start einschließlich, Ende ausschließlich; Sitzungen über Mitternacht erlaubt. Keine eigenen Feiertagsdaten. Alle Zahlen, Kurse und Vorgaben liefert der Aufrufer. Keine eigenen Kursdaten, kein Brokerzugriff, keine Ausführung. Rechenwerkzeug, keine Anlageberatung, keine Empfehlung.

## Output

A structured response indicating whether the provided UTC timestamp falls within any of the caller-supplied trading sessions, accounting for weekday filtering, start/end times (exclusive of end), midnight-crossing sessions, and any explicitly closed dates. No price data, broker access, or financial advice is provided — purely a time-in-session Boolean computation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sessions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "weekday",
     "start",
     "end"
    ],
    "properties": {
     "end": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
     },
     "start": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1
     },
     "weekday": {
      "type": "integer",
      "maximum": 6,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 0
  },
  "time_utc": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  },
  "timezone": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  },
  "closed_dates": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 64,
    "minLength": 1
   },
   "maxItems": 1000,
   "minItems": 0
  }
 }
}
```

## More

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