// Last updated 2026-04-30

REST API v1

A public REST API for searching ERC-8004 agents, fetching feedback, listing validations, and computing reputation scores across every indexed EVM chain.

Pay-per-request via x402

Every REST call accepts a stablecoin micropayment per request:

• Chain: Base mainnet (production); Base Sepolia (staging).
• Currency: USDC.
• Amount: $0.001 USDC per request (subject to change; advertised in the accepts field of every 402 response).

If you don’t include a payment header, the server returns 402 Payment Required with the price and recipient details. Sign a payment, replay the request with the X-PAYMENT header, and you get the data. See x402 payment flow for the full walkthrough and a curl example.

There’s no API key to provision, no contract to sign — any wallet that holds USDC on Base can call the API.

Rate limiting

Per-IP soft cap: 300 requests/min globally, with a 60 requests/min cap on /v1/agents. Calls beyond the cap return 429 Too Many Requests with a Retry-After header. The cap applies per source IP, so clients sharing a NAT share the bucket. If you need higher sustained throughput, the JSON-RPC API distributed via the QuickNode marketplace add-on ships with paid tiers that lift the cap.

Endpoints

• Agents — GET /v1/agents, GET /v1/agents/:agent_id, plus per-agent feedback, validations, validation summary, and reputation.
• Feedback — global feedback feed.
• Validators — per-validator request lookups.
• x402 payment flow — how to sign and replay a payment.

Postman collection

A maintained Postman collection lives at /docs/collections/postman.json. Import it into Postman or Insomnia for a quick start.

What’s not paywalled

• The Explorer UI (/, /agents/..., /feedback, /validations, /status) — open to humans and crawlers.
• /healthz, /up — operational health endpoints.