# Current Time by Timezone

> Current Time by Timezone is a paid API for AI agents from time.memoryapi.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the current time for any timezone, including datetime, Unix epoch, UTC offset, DST status, day of week/year, and week number.

## Facts

- Endpoint: GET https://time.memoryapi.org/x402/time/current
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-memoryapi-org-b059df2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7mnzJJXcHhxjo1wgvVGui

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 time-memoryapi-org-b059df2f
```

Example prompt: What's the current time in Tokyo — give me the datetime, UTC offset, whether DST is active, and the Unix epoch timestamp.

## When to prefer this

Use this endpoint when you need precise, structured current time data for a specific timezone — especially when you need multiple time-related fields at once (epoch, DST, week number, day of year) rather than a simple clock display. Prefer this over generic date libraries when the agent needs authoritative server-side time with DST awareness.

## Known failure modes

- Invalid or unrecognized timezone name returns an error
- Missing timezone parameter returns a bad request error
- Payment failure (x402) blocks the request
- Network timeout if the service is unavailable

## How this service works

Time, astronomy, and moon phase data via x402 micropayments. Powered by TimeAPI.io and US Naval Observatory.

## Output

Returns the current datetime string, Unix epoch timestamp, UTC offset, DST active flag, day of the week, day of the year, and ISO week number for the requested timezone.

## Example request

```json
{
 "tz": 9,
 "lat": 35.6762,
 "lon": 139.6503
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "is_dst": true,
  "source": "TimeAPI.io",
  "success": true,
  "timezone": "America/New_York",
  "unix_epoch": 1748480640,
  "utc_offset": "-05:00",
  "day_of_week": "Thursday",
  "local_datetime": "2025-05-29T03:04:00"
 }
}
```

## More

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