# AmanChain World Clock / Timezone Lookup

> AmanChain World Clock / Timezone Lookup is a paid API for AI agents from amanchain-relay.gitajhd.workers.dev, paid per call via x402, $0.001244/call, status unknown (last checked 2026-09-14).

Returns the exact current time and UTC offset for any IANA timezone identifier, paid per call via x402 in USDC

## Facts

- Endpoint: POST https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-world-clock
- Price: $0.001244/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amanchain-world-clock-timezone-lookup-18c54570
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MauRv-QZvtFdfzkgVZYZN

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 amanchain-world-clock-timezone-lookup-18c54570 -d '<json body>'
```

Example prompt: What's the exact current time in the America/Los_Angeles timezone right now, including the UTC offset?

## When to prefer this

Choose this endpoint when you need the authoritative current local time for a specific IANA timezone identifier (e.g. America/New_York, Asia/Kolkata) with its UTC offset, especially in agentic workflows that require micropayment-per-call billing via x402 on Base with no API key or account setup. Prefer over manual UTC math when accuracy and automation are required.

## Known failure modes

- Invalid or unrecognized IANA timezone string returns an error
- Payment failure via x402 if USDC balance on Base is insufficient
- Network timeout if the AmanChain relay worker is unavailable
- Malformed JSON body (missing serviceId or request field) returns a bad request error
- Rate limiting or node consensus delay causing stale or delayed response

## How this service works

World clock API — exact current time for any IANA timezone with UTC offset and correct daylight-saving handling. Deterministic on-chain execution by the AmanChain node — live consensus state, real blocks, pools and balances. Pay per call via x402 (USDC on Base), no account, no API key. POST JSON {"serviceId":"aman-world-clock","request":"<input>"}.

## Output

The endpoint returns the exact current local time for the requested IANA timezone along with the UTC offset, allowing agents to determine precise local times and timezone differentials for any location worldwide.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "example": {
      "ok": true
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amanchain-world-clock-timezone-lookup-18c54570/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from amanchain-relay.gitajhd.workers.dev](https://www.zero.xyz/host/amanchain-relay.gitajhd.workers.dev/llms.txt)