# WebRef Unix Timestamp Lookup

> WebRef Unix Timestamp Lookup is a paid API for AI agents from webref.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Returns the current Unix timestamp (and optionally parses a date or existing timestamp) for use in deadline arithmetic and time calculations

## Facts

- Endpoint: GET https://webref.johnaio281.workers.dev/api/time/unix_time?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/webref-unix-timestamp-lookup-881e92f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CxjYq8conc7hNpsDFerE7

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 webref-unix-timestamp-lookup-881e92f7
```

Example prompt: What is the current Unix timestamp right now, and also what Unix timestamp does the date 2025-12-31 correspond to?

## When to prefer this

Choose this endpoint when an AI agent needs an authoritative current Unix timestamp or needs to convert a human-readable date string to epoch seconds without standing up its own time service. Especially useful for agents doing deadline arithmetic, setting expiry fields, or stamping logs, when they cannot rely on local system clocks or need a pay-per-call, no-signup solution. Prefer over building date-math locally when correctness and simplicity matter.

## Known failure modes

- Invalid date string supplied — returns an error indicating the date could not be parsed
- Non-finite or out-of-range numeric timestamp — rejected by schema validation
- Payment not fulfilled (402) — x402 or MPP payment must be completed before the response is returned
- Network timeout on the Cloudflare Worker edge
- Unsupported HTTP method (only GET, HEAD, DELETE accepted)

## How this service works

Web standards and time reference for AI agents: HTTP status codes with what the client should do, retry semantics, MIME types and content-type matching, request-method safety and idempotency, plus deadline arithmetic - time until a moment, weekday and business-day checks, duration conversion and Unix timestamps. Pay per call in USDC on Base via x402 or USDC on Tempo via MPP. No signup, no API key, no KYC.

## Output

Returns the current Unix timestamp as an integer (seconds since the Unix epoch, January 1 1970 00:00:00 UTC), or the Unix timestamp corresponding to a supplied date string or numeric timestamp. The response provides a machine-readable epoch value suitable for deadline arithmetic, expiry calculations, and time comparisons.

## 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": {
     "date": {
      "def": {
       "type": "optional",
       "innerType": {
        "def": {
         "type": "string"
        },
        "type": "string"
       }
      },
      "type": "optional"
     },
     "type": "object",
     "timestamp": {
      "def": {
       "type": "optional",
       "innerType": {
        "def": {
         "type": "number",
         "checks": []
        },
        "type": "number",
        "isFinite": true
       }
      },
      "type": "optional"
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/webref-unix-timestamp-lookup-881e92f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from webref.johnaio281.workers.dev](https://www.zero.xyz/host/webref.johnaio281.workers.dev/llms.txt)