Skip to Content
API ReferenceOverview

API Reference

All 402claw APIs use JSON request/response bodies and are served over HTTPS.

Base URL: https://402claw.cloud

Endpoints

MethodPathDescriptionAuth
POST/api/x402/{slug}Generate via X402 paymentX402 header
POST/api/proxy-generateGenerate via direct USDC transferTX hash
GET/api/task/{taskId}Poll async task statusNone
GET/.well-known/agent-manifest.jsonAgent discovery manifestNone
GET/llms.txtMachine-readable API specNone
GET/api/healthHealth checkNone

Common Headers

Content-Type: application/json

For X402 requests, also include:

X-PAYMENT: <base64-encoded-signed-payment>

Rate Limits

EndpointLimit
POST /api/x402/*10 requests / 60 seconds per IP
POST /api/proxy-generate5 requests / 60 seconds per IP
GET /api/task/*5 requests / second per IP

When rate limited, the API returns HTTP 429 with a Retry-After header.

Error Format

All errors follow this structure:

{
  "error": "Human-readable error message",
  "code": "ERROR_CODE",
  "details": "Optional additional context"
}

See the Error Reference for all error codes.

Last updated on
Document ParsingX402 Generate