# Duo Data Utilities – Time Zone Conversion > Duo Data Utilities – Time Zone Conversion is a paid API for AI agents from api.duoleads.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-02). Converts an instant to wall-clock time in a named IANA time zone, or a local wall-clock time back to an instant, with full DST boundary handling and rich calendar metadata. ## Facts - Endpoint: GET https://api.duoleads.com/v1/time/zone?utm_source=zero.xyz - Price: $0.05/call - Payment: x402 - Status: unknown - Last checked: 2026-10-02 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/duo-data-utilities-time-zone-conversion-d9e2a5dd - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EO-nH3SqvV03xGCBlW-Y1 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 duo-data-utilities-time-zone-conversion-d9e2a5dd ``` Example prompt: What is the local time and UTC offset in America/New_York for the instant 2026-03-08T06:30:00Z, and is DST in effect? ## When to prefer this Choose this endpoint when you need authoritative DST-aware timezone conversion with explicit handling of ambiguous and skipped local times — rather than relying on client-side libraries that may have stale timezone data or silently guess at DST boundaries. Ideal when you need the full suite of calendar metadata (ISO week, day of year, UTC offset in seconds) in a single deterministic call at a low fixed cost of $0.05 USDC. ## Known failure modes - Unknown or invalid IANA zone name returns a 4xx error - Providing both 'instant' and 'local' simultaneously is rejected as mutually exclusive - A skipped local time (spring-forward gap) with ambiguous=reject returns an explicit error rather than guessing - Malformed RFC 3339 or non-numeric epoch string causes a validation error - Missing required 'zone' parameter returns a schema validation error ## How this service works Convert an instant to wall-clock time in a named IANA time zone, or a wall-clock time in a zone back to an instant. Returns the local date and time, the UTC offset in ±HH:MM and seconds, the zone abbreviation, whether DST is in effect, the ISO week date, and the day of year. Handles the ambiguous and skipped local times at DST boundaries explicitly rather than guessing. ## Output A JSON object with: local datetime string, UTC offset in ±HH:MM and integer seconds, zone abbreviation (e.g. CET), DST boolean, gap/fold booleans for boundary detection, ambiguity and resolution fields, ISO week (week number, year, weekday), day of year, and Unix epoch milliseconds. Also includes a meta block with request ID, computation timestamp, price, and determinism flag. ## 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": [ "zone" ], "properties": { "zone": { "type": "string", "maxLength": 64, "description": "IANA time zone id, e.g. Europe/Amsterdam." }, "local": { "type": "string", "maxLength": 64, "description": "Wall-clock time YYYY-MM-DDTHH:MM[:SS] in zone, converted back to an instant. Mutually exclusive with instant." }, "instant": { "type": "string", "maxLength": 64, "description": "RFC 3339 timestamp or integer Unix seconds/milliseconds. Defaults to now. Mutually exclusive with local." }, "ambiguous": { "enum": [ "earlier", "later", "reject" ], "type": "string", "maxLength": 64, "description": "Only with local: which instant a repeated local time maps to. Default earlier." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "ok", "route", "version", "data", "meta" ], "properties": { "ok": { "const": true }, "data": { "type": "object", "required": [ "zone", "instant", "epoch_ms", "local", "offset", "offset_seconds", "abbreviation", "dst", "weekday", "iso_week", "day_of_year", "ambiguity", "resolution" ], "properties": { "dst": { "type": "boolean" }, "gap": { "type": "boolean" }, "zone": { "type": "string" }, "local": { "type": "string" }, "offset": { "type": "string" }, "instant": { "type": "string" }, "weekday": { "type": "string" }, "epoch_ms": { "type": "integer" }, … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "ok": true, "data": { "dst": true, "gap": false, "zone": "Europe/Amsterdam", "local": "2026-10-25T02:30:00", "offset": "+02:00", "instant": "2026-10-25T00:30:00.000Z", "weekday": "sunday", "epoch_ms": 1792888200000, "iso_week": { "week": 43, "year": 2026, "weekday": 7 }, "ambiguity": null, "resolution": null, "day_of_year": 298, "abbreviation": "GMT+2", "offset_seconds": 7200 }, "meta": { "price_usd": "0.05", "disclaimer": "Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms", "request_id": "01K6B7Q4ZC8H3F2M9WXR5TYN0D", "computed_at": "2026-09-28T12:00:00.000Z", "deterministic": true }, "route": "/v1/time/zone", "version": "1.0.0" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/duo-data-utilities-time-zone-conversion-d9e2a5dd/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.duoleads.com](https://www.zero.xyz/host/api.duoleads.com/llms.txt)