# x402-tools Timezone Math

> x402-tools Timezone Math is a paid API for AI agents from x402.nichospt.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Converts a datetime from one IANA timezone to another, supporting both structured ISO 8601 input and natural language queries like '3pm PT next Thursday in IST'.

## Facts

- Endpoint: POST https://x402.nichospt.net/timezone-math?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-tools-timezone-math-b871de78
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tjIxC23_1oJcmWtgNd3s1

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 x402-tools-timezone-math-b871de78 -d '<json body>'
```

Example prompt: What time is 3pm Pacific Time this coming Thursday in IST? I need to know so I can send a meeting invite with the right time for my colleague in India.

## When to prefer this

Use this endpoint when you need to convert a specific datetime (structured or natural language) between IANA timezones and want both a machine-readable ISO result and a human-readable string. Especially useful when the user phrases the time in natural language like '3pm PT next Thursday'. Prefer this over generic date libraries when you need server-side parsing of relative phrases against a reference date, or when you need the offset difference explicitly returned.

## Known failure modes

- Invalid or unrecognized IANA timezone string returns an error
- Ambiguous natural language query that cannot be parsed returns an error
- Providing both 'query' and 'datetime'/'from' simultaneously (mutually exclusive inputs) returns a validation error
- Missing required 'to' field returns a validation error
- Payment not settled via x402 protocol returns a 402 Payment Required response

## How this service works

Pay-per-call utility APIs for AI agents, settled in USDC via the x402 protocol.

## Output

Returns a JSON object with the target timezone, source timezone, the converted datetime in ISO 8601 format with offset, a human-readable datetime string in the target zone, the original interpreted query, and the UTC offset difference in hours between source and target.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "description": "Target IANA timezone (required)"
  },
  "from": {
   "type": "string",
   "description": "Source IANA timezone (e.g. 'America/Los_Angeles')"
  },
  "query": {
   "type": "string",
   "description": "Natural language form (e.g. '3pm PT next Thursday in IST'). Mutually exclusive with datetime+from."
  },
  "datetime": {
   "type": "string",
   "description": "ISO 8601 datetime or 'YYYY-MM-DD HH:mm'"
  },
  "reference": {
   "type": "string",
   "description": "ISO date used as the reference for relative phrases in `query`"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to_zone": "Asia/Tokyo",
  "from_zone": "America/Los_Angeles",
  "result_iso": "2026-06-02T07:00:00.000+09:00",
  "result_human": "June 2, 2026, 7:00:00 AM Japan Standard Time",
  "interpreted_query": "2026-06-01 15:00 America/Los_Angeles",
  "offset_difference_hours": 16
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-tools-timezone-math-b871de78/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.nichospt.net](https://www.zero.xyz/host/x402.nichospt.net/llms.txt)