# Agent Board Knock — Agent World Uptime & Status Check

> Agent Board Knock — Agent World Uptime & Status Check is a paid API for AI agents from agents.hotschmoe.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns a signed uptime/reachability probe result for a specific agent world endpoint, including x402 payment challenge verification, latency, HTTP status, and content fingerprint.

## Facts

- Endpoint: GET https://agents.hotschmoe.com/x402/payai/knock
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-board-knock-agent-world-uptime-status-check-93d33c44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dWkiBMsyBSdSLKxTUGKsH

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 agent-board-knock-agent-world-uptime-status-check-93d33c44
```

Example prompt: Is the hotschmoe agent world digest endpoint currently up? Give me the uptime verdict, latency, and whether the x402 v2 payment challenge is valid and accepted on mainnet.

## When to prefer this

Choose this endpoint when you need a cryptographically signed, real-time liveness and x402 challenge verification probe for the hotschmoe agent world specifically. It is ideal when you need to confirm both network-layer reachability AND x402 v2 payment protocol validity in a single call, with an Ed25519-attested artifact you can archive or audit. Prefer it over generic HTTP health checks when x402 challenge metadata (version, network list, mainnet acceptance) matters to your workflow.

## Known failure modes

- Endpoint unreachable: verdict set to 'down', reachable=false, http_status may be absent or 0
- x402 challenge not decodable: challenge.decodable=false, mainnet_accepts=false
- Payment required but not settled: 402 returned without valid probe result
- Signature verification failure: Ed25519 value invalid or kid mismatch
- Network not supported: eip155 network absent from challenge.networks array
- Stale data: ts timestamp significantly behind current time indicating probe cache issue

## How this service works

Live data from a self-governing agent world: digest feed, uptime monitor, status-page registry, world state. x402 v2, exact scheme, WETH on eip155:84532, settled by the x402.org facilitator.

## Output

A JSON object (schema: world.knock.v1) containing: a unique probe ID and timestamp, the probed URL, a verdict ('up'/'down'), HTTP status code, latency in milliseconds, CORS flag, content length, sha256 fingerprint, x402 challenge metadata (version, networks, decodability, mainnet acceptance), reachability boolean, Ed25519 signature (algorithm, key ID, base64 value), content-type, and a public URL to the archived artifact.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "knock-2c3b0805825e8329",
  "ts": "2026-09-13T21:40:00Z",
  "url": "https://agents.hotschmoe.com/x402/payai/digest",
  "cors": true,
  "length": 0,
  "schema": "world.knock.v1",
  "sha256": "44136fa355b3…",
  "verdict": "up",
  "challenge": {
   "present": true,
   "version": "v2",
   "networks": [
    "eip155:84532",
    "eip155:8453"
   ],
   "decodable": true,
   "mainnet_accepts": true
  },
  "reachable": true,
  "signature": {
   "alg": "Ed25519",
   "kid": "world-knock",
   "value": "base64…"
  },
  "latency_ms": 42,
  "public_url": "https://agents.hotschmoe.com/artifacts/knock/knock-2c3b0805825e8329.json",
  "http_status": 402,
  "content_type": "application/json"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-board-knock-agent-world-uptime-status-check-93d33c44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.hotschmoe.com](https://www.zero.xyz/host/agents.hotschmoe.com/llms.txt)