# Time Zone Converter

> Time Zone Converter is a paid API for AI agents from flat-rate-llm.kikoribera03.workers.dev, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-15).

Converts a wall-clock time from one IANA time zone to another, applying DST rules and warning about ambiguous or non-existent local times.

## Facts

- Endpoint: POST https://flat-rate-llm.kikoribera03.workers.dev/v1/time/convert
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-zone-converter-6928a315
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JZGJVpz4YwPkXG6vqXgP6

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 time-zone-converter-6928a315 -d '<json body>'
```

Example prompt: What time will it be in Tokyo (Asia/Tokyo) when it's 3:00 PM on 2025-06-15 in New York (America/New_York)? Also tell me the UTC offset and whether DST is active on both ends.

## When to prefer this

Choose this endpoint when you need authoritative, DST-aware time zone conversion backed by a real tz database — especially when the conversion date falls near a DST transition and you need an explicit warning if the time is ambiguous or non-existent. Prefer it over hand-rolled UTC-offset arithmetic for any production scheduling, calendar, or logging task that crosses DST boundaries.

## Known failure modes

- Invalid or unrecognized IANA time zone string returns an error — e.g. 'US/Eastern' vs 'America/New_York'
- Malformed time string that cannot be parsed returns an error
- Missing required 'from' or 'to' parameters returns a validation error
- Time in a DST gap (e.g. 2:30 AM on spring-forward day) returns a warning rather than a hard error but result may be adjusted
- Payment not made or x402 auth failure returns 402 Payment Required

## How this service works

60 paid endpoints with no metering, no API key and no account. Each endpoint has one flat price per call, whatever the size of the request: LLM completions with automatic failover across several large models, read-only EVM tooling over Base, Ethereum, Polygon, Arbitrum and Optimism, and pure crypto utilities that touch no network.

## Output

Returns a JSON object with two nested objects (from and to zones) each containing the local time, UTC offset, abbreviation, and DST flag; plus the shared UTC instant as an ISO string, the hour difference between the two zones, and any warning if the requested time falls in a DST gap (non-existent) or overlap (ambiguous).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "to",
  "from"
 ],
 "properties": {
  "to": {
   "type": "string",
   "description": "Target IANA time zone, e.g. \"Asia/Tokyo\". Required."
  },
  "from": {
   "type": "string",
   "description": "Source IANA time zone, e.g. \"Europe/Madrid\". Required."
  },
  "time": {
   "type": "string",
   "description": "Wall clock as YYYY-MM-DD HH:MM in the \"from\" zone, or an ISO string with Z or an offset, or a unix timestamp, or \"now\". Defaults to now."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "object"
  },
  "from": {
   "type": "object"
  },
  "instantUtc": {
   "type": "string"
  },
  "differenceHours": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/time-zone-converter-6928a315/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flat-rate-llm.kikoribera03.workers.dev](https://www.zero.xyz/host/flat-rate-llm.kikoribera03.workers.dev/llms.txt)