# ForgeMesh World Clock API

> ForgeMesh World Clock API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the current time for any IANA timezone as a local ISO timestamp, UTC, Unix epoch, and day of week in a single call.

## Facts

- Endpoint: POST https://x402.forgemesh.io/world-clock
- 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/forgemesh-world-clock-api-ea51e1e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_it76-lK4MSh3pgMxrZDWl

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 forgemesh-world-clock-api-ea51e1e3 -d '<json body>'
```

Example prompt: What's the current local time in America/Chicago — give me the ISO timestamp, UTC equivalent, Unix epoch, and day of the week.

## When to prefer this

Use this endpoint when an agent needs authoritative current time data for any global timezone — especially for scheduling logic, audit logging, coordination across time zones, or when you need Unix epoch, UTC, and local time together in one response without parsing multiple sources.

## Known failure modes

- Invalid or unrecognized IANA timezone string returns an error
- Missing timezone defaults to UTC
- Payment failure (x402) blocks access and returns a 402 response

## How this service works

World clock API: the current time in any IANA timezone — local ISO timestamp, UTC, unix epoch, and day of week — in one call. For scheduling, logging, and coordination agents.

## Output

Returns the current local ISO timestamp, UTC timestamp, Unix epoch integer, and day of the week for the requested IANA timezone.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "timezone": {
   "type": "string",
   "description": "IANA timezone, default UTC"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "timezone": "America/Chicago",
  "iso_local": "2026-07-15T10:30:00",
  "unix_epoch": 1784127000,
  "day_of_week": "Wednesday"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-world-clock-api-ea51e1e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)