# HALOWERK Timezone Converter (Broker to UTC / UTC to Broker)

> HALOWERK Timezone Converter (Broker to UTC / UTC to Broker) 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).

Converts timestamps between UTC and a broker's local timezone (or vice versa) using a strict IANA timezone, with explicit handling of DST fold ambiguities and rejection of non-existent times.

## Facts

- Endpoint: POST https://handel.halowerk.com/v1/rechner/timezone?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-timezone-converter-broker-to-utc-utc-to-broker-1731bd27
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jDuON48IGCFB_gllIhW2s

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-timezone-converter-broker-to-utc-utc-to-broker-1731bd27 -d '<json body>'
```

Example prompt: Convert 09:30 AM on November 5, 2023 in the America/New_York timezone to UTC — use broker_to_utc mode, and since that's a DST fall-back overlap hour, set fold to 1 for the second occurrence.

## When to prefer this

Use this endpoint when you need precise, rules-compliant conversion between UTC and a financial broker's local timezone, especially when DST transitions or clock-overlap ambiguities must be handled correctly. It is ideal for trade timestamp reconciliation, session scheduling, and any workflow where incorrect timezone handling could cause compliance or operational issues. It does NOT provide market data, execute trades, or offer investment advice.

## Known failure modes

- Invalid or non-IANA timezone string returns an error
- Non-existent local time (e.g. during DST spring-forward gap) is rejected
- Missing required fields (mode, time, timezone) cause a validation error
- Ambiguous local time without an explicit fold value may be rejected or flagged
- Malformed time string (wrong format or length) causes a parse error

## How this service works

Broker-Zeit und UTC umrechnen. IANA-Zeitzone zwingend; doppelte Ortszeit nur mit ausdrücklich geliefertem fold, nicht existierende Zeit wird abgewiesen. Alle Zahlen, Kurse und Vorgaben liefert der Aufrufer. Keine eigenen Kursdaten, kein Brokerzugriff, keine Ausführung. Rechenwerkzeug, keine Anlageberatung, keine Empfehlung.

## Output

Returns the converted timestamp in the target timezone (either UTC or broker local time), correctly accounting for IANA timezone rules, DST transitions, and explicit fold disambiguation. Non-existent local times (e.g. during spring-forward gaps) are rejected with an error.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fold": {
   "type": "integer",
   "maximum": 1,
   "minimum": 0
  },
  "mode": {
   "enum": [
    "utc_to_broker",
    "broker_to_utc"
   ],
   "type": "string"
  },
  "time": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  },
  "timezone": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-timezone-converter-broker-to-utc-utc-to-broker-1731bd27/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)