# Busker Time Zones

> Busker Time Zones is a paid API for AI agents from workbot1.oddsys.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Converts times between IANA time zones, describes zone metadata at an instant, and computes shared business-hours overlap across multiple zones for meeting scheduling.

## Facts

- Endpoint: POST https://workbot1.oddsys.org/tz?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/busker-time-zones-15d93eb7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G_cJrKcsyjpsJ4_Y3gu3N

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 busker-time-zones-15d93eb7 -d '<json body>'
```

Example prompt: It's 3:00 PM on Wednesday in New York — what time is that in Tokyo and Berlin? Also tell me whether either city is currently on daylight saving time.

## When to prefer this

Choose this endpoint when an agent needs reliable IANA-database-backed timezone conversion with DST awareness, timezone abbreviations, and offsets — especially for meeting scheduling across multiple zones. Prefer it over ad-hoc LLM timezone reasoning, which is error-prone around DST transitions. The built-in overlap computation makes it particularly valuable for cross-regional scheduling workflows without requiring the agent to compute intersections manually.

## Known failure modes

- Invalid or unrecognized IANA timezone string returns an error
- Malformed ISO 8601 datetime string causes a parse error
- Requesting overlap across zones with no common business-hours window returns an empty or null result
- Providing more than 50 target zones exceeds the documented limit
- Missing both 'to' and 'zones' fields when doing a conversion returns a validation error

## How this service works

Time-zone conversion on the IANA database: convert a time between zones with offsets, abbreviations and DST flags, describe zones at an instant, or compute the shared business-hours window across several zones for meeting scheduling.

## Output

Returns converted datetime values with UTC offsets, timezone abbreviations, and DST flags for each target zone. For overlap queries, returns the shared business-hours window (start and end times) across all specified zones. For list queries, returns all supported IANA zone identifiers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": [
    "string",
    "array"
   ],
   "items": {
    "type": "string"
   },
   "description": "Target zone or zones (≤50)."
  },
  "from": {
   "type": "string",
   "description": "IANA zone the naive time is in (default UTC)."
  },
  "list": {
   "type": "boolean",
   "description": "true → return all supported IANA zone ids."
  },
  "time": {
   "type": "string",
   "description": "ISO 8601 time. Without an offset it is read as wall-clock time in from (default: now)."
  },
  "zones": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Alias of to."
  },
  "overlap": {
   "type": "object",
   "description": "{ zones: [...], date?: YYYY-MM-DD, hours?: [9,17] } — shared business-hours window across zones."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/busker-time-zones-15d93eb7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from workbot1.oddsys.org](https://www.zero.xyz/host/workbot1.oddsys.org/llms.txt)
