# Epoch Convert API

> Epoch Convert API is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-20).

Converts Unix epoch timestamps (seconds or milliseconds) or ISO date strings to multiple human-readable and machine-readable formats, with timezone support

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/epoch-convert?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/epoch-convert-api-cfb90ea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XshkzGK9e0QowCaQJUV-W

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 epoch-convert-api-cfb90ea1 -d '<json body>'
```

Example prompt: Can you convert the Unix timestamp 1700000000 to a human-readable date and time in America/Chicago timezone?

## When to prefer this

Use this endpoint when you need to convert Unix epoch timestamps (seconds or milliseconds) or ISO strings to multiple formats simultaneously, especially when timezone localization is required. Prefer this over manual datetime parsing when you need both the UTC and local timezone representations in a single call, or when you need the epoch round-trip (input as ISO, get back epoch values).

## Known failure modes

- Invalid or unparseable timestamp value returns an error response
- Unrecognized timezone string (e.g. misspelled IANA name) may return an error or fall back to UTC
- Missing 'value' field in request body causes a validation error
- Payment not made upfront results in HTTP 402 requiring x402 USDC payment on Base before retry

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

A JSON object containing: the original epoch in both seconds and milliseconds, an ISO 8601 UTC datetime string, an ISO 8601 timezone-adjusted datetime string, the UTC offset for the requested timezone, the timezone name used, and a classification of what type of input was provided (e.g. epoch_s, epoch_ms, or iso string).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tz": {
   "type": "string",
   "default": "UTC",
   "maxLength": 64,
   "minLength": 1
  },
  "value": {
   "type": [
    "integer",
    "number",
    "string"
   ],
   "maxLength": 64
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tz": "America/Chicago",
  "skill": "epoch_convert",
  "iso_tz": "2023-11-14T16:13:20-06:00",
  "epoch_s": 1700000000,
  "iso_utc": "2023-11-14T22:13:20Z",
  "epoch_ms": 1700000000000,
  "input_kind": "epoch_s",
  "utc_offset": "-06:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/epoch-convert-api-cfb90ea1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
