# City Timezone Lookup API

> City Timezone Lookup API is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Returns the IANA timezone name, UTC offset, and current local time for a given city, with DST awareness.

## Facts

- Endpoint: GET https://api.cn402.com/geo/timezone
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-7085378e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZHNBRXijcGffjfVfQzcen

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 api-cn402-com-7085378e
```

Example prompt: What's the IANA timezone name and current local time for Chengdu? I need to know the UTC offset and whether daylight saving time is in effect.

## When to prefer this

Use this endpoint when you need to resolve a city name (especially Chinese cities) to a structured IANA timezone identifier with UTC offset and local time. Prefer over generic timezone APIs when working with mainland Chinese cities or when you need DST-aware timezone lookup via a pay-per-call x402 model.

## Known failure modes

- City name not recognized — returns error or empty result
- Ambiguous city name matching multiple locations — may return unexpected timezone
- Non-Chinese or unsupported city names may not be covered
- Malformed POST body — returns 400 bad request
- Payment failure (x402) — returns 402 Payment Required

## How this service works

Timezone lookup by city, city timezone API, Chinese city timezone, city UTC offset, 时区查询, IANA timezone name, city local time, DST aware timezone lookup, timezone by city name. Look up the IANA timezone, UTC offset, and current local time for a given city.

## Output

Returns the IANA timezone identifier (e.g. 'Asia/Chengdu'), UTC offset in hours, current local time at the given city, and DST awareness flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lat": {
   "type": "string",
   "description": "Lat (optional)"
  },
  "lng": {
   "type": "string",
   "description": "Lng (optional)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-7085378e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)