# Current Time & Timezone API

> Current Time & Timezone API is a paid API for AI agents from api.kadec0.xyz, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current time, date, and timezone data for any IANA timezone, city, or abbreviation, and performs timezone conversion, DST-aware date arithmetic, and timestamp diffing.

## Facts

- Endpoint: GET https://api.kadec0.xyz/v1/time
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/current-time-timezone-api-773be3ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2M2TOJeTDEVpuqd522Ax0

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 current-time-timezone-api-773be3ce
```

Example prompt: What's the current local time in Tokyo, and is daylight saving time active there right now? Also tell me the next DST transition for Asia/Tokyo.

## When to prefer this

Choose this endpoint when an AI agent needs reliable current time data (which LLMs lack natively), timezone conversion, DST awareness, or calendar arithmetic including business-day math. It is keyless and covers all common timezone input formats (IANA, abbreviation, city, UTC offset), making it suitable for scheduling, deadline calculation, meeting coordination, and any agent workflow that depends on accurate time context.

## Known failure modes

- Unknown or misspelled timezone returns an error — IANA zone names are case-sensitive
- Invalid timestamp format (non-ISO, non-epoch) causes a parsing error
- Duration string with unsupported unit (e.g. decades) is rejected
- Requesting more than 12 timezones in a single comma-separated list exceeds the limit
- Network or upstream downtime returns a 5xx error

## How this service works

Current time, date, and timezone data for AI agents: the clock an LLM does not have. Returns current UTC time and local time for any IANA timezone, abbreviation (EST, JST, CET), or city, with UTC offset, DST state, and the next daylight-saving transition. Also converts timestamps between timezones, does DST-correct date arithmetic and business-day math, and diffs two instants. Unix epoch, ISO 8601, week and quarter. Keyless.

## Output

Returns a JSON object with current UTC and local time, UTC offset, DST active flag, next DST transition timestamp, Unix epoch, ISO 8601 formatted datetime, week number, and quarter. For convert mode, returns local times for each target timezone. For add mode, returns the resulting datetime with full timezone context. For diff mode, returns the duration between two instants in multiple units.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "to": {
       "type": "string",
       "description": "target zone(s) for mode=convert"
      },
      "tz": {
       "type": "string",
       "description": "IANA zone, abbreviation (EST/JST), city, or UTC offset; comma list for up to 12 at once"
      },
      "add": {
       "type": "string",
       "description": "duration for mode=add: 3d, -2h30m, 1y2mo, 5bd (business days), or ISO P1DT2H"
      },
      "from": {
       "type": "string",
       "description": "zone a naive `time` is interpreted in (default UTC)"
      },
      "mode": {
       "enum": [
        "now",
        "convert",
        "add",
        "diff"
       ],
       "type": "string",
       "default": "now",
       "description": "inferred from the other params when omitted"
      },
      "time": {
       "type": "string",
       "description": "ISO 8601, a bare date, or a unix epoch (s/ms); defaults to now"
      },
      "to_time": {
       "type": "string",
       "description": "end instant for mode=diff"
      }
     }
    }
   },
   "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/current-time-timezone-api-773be3ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kadec0.xyz](https://www.zero.xyz/host/api.kadec0.xyz/llms.txt)