# FiatDock Time Zone Converter

> FiatDock Time Zone Converter is a paid API for AI agents from fiatdock.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Converts a single instant to local time across up to 20 IANA time zones, returning offset, abbreviation, DST state, weekday, and date for each.

## Facts

- Endpoint: GET https://fiatdock.com/v1/time/convert?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fiatdock-time-zone-converter-2b207651
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_et1xYLW_-xgMZrzYVH618

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 fiatdock-time-zone-converter-2b207651
```

Example prompt: What time will it be in London, Tokyo, and Sydney when it's 3pm on October 8th 2026 in New York?

## When to prefer this

Choose this endpoint when you need accurate multi-zone time conversion with DST awareness, explicit offset and abbreviation data, and ambiguity resolution for clock-change edge cases — especially when you need results across many zones (up to 20) in one call. Prefer it over manual offset arithmetic or generic datetime libraries when DST correctness and IANA zone support matter.

## Known failure modes

- 400 Bad Request: malformed time string, invalid ISO 8601 format, year outside 1970-2100, or more than 20 zones requested — not charged
- 404 Not Found: unrecognized IANA time zone name — not charged
- Empty or missing 'to' defaults to 8 preset zones; missing 'time' defaults to now

## How this service works

One instant as wall-clock time in up to 20 IANA time zones: local time with offset, abbreviation, DST state, weekday and date. A local time is read in `from`; one skipped or repeated by a DST change is resolved by a stated rule and flagged. Years 1970-2100. Send {} for now in eight major zones. Bad input is 400, an unknown zone 404 - neither is charged. Pay-per-call via x402.

## Output

A JSON object containing the resolved instant with local time, UTC offset, timezone abbreviation, DST flag, weekday name, and date for each requested IANA time zone, plus the source (from) local time representation and any DST-ambiguity resolution 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": [],
     "properties": {
      "to": {
       "type": "string",
       "example": "Europe/Berlin,Asia/Tokyo",
       "description": "IANA time zones to show the instant in, up to 20 (default America/Los_Angeles,America/New_York,Europe/London,Europe/Berlin,Asia/Dubai,Asia/Kolkata,Asia/Tokyo,Australia/Sydney) (comma-separated, or a JSON array)"
      },
      "from": {
       "type": "string",
       "example": "America/New_York",
       "maxLength": 64,
       "description": "IANA time zone a local `time` is read in (and shown in as fromLocalTime), e.g. America/New_York; default UTC"
      },
      "time": {
       "type": "string",
       "example": "2026-10-08T15:00",
       "maxLength": 40,
       "description": "The moment to convert, ISO 8601: with Z or an offset (\"2026-10-08T15:00:00Z\", \"2026-10-08T15:00+02:00\") it is an absolute instant; without one (\"2026-10-08T15:00\") it is wall-clock time in `from`; a bare date means 00:00 there. Years 1970-2100. Default: now"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fiatdock-time-zone-converter-2b207651/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fiatdock.com](https://www.zero.xyz/host/fiatdock.com/llms.txt)
