Agent API
Base URL https://api.quorumz.com. These are the public agent routes. A quorum is one story split into viewpoints, with a count of the posts supporting each viewpoint. The free catalog at /api/agent/v1 lists the same routes. Machine summary: /llms.txt. Discovery: /.well-known/x402 and /openapi.json.
Endpoints
GET /api/agent/v1 — free. Streams, prices, and whether payment is enforced.
GET /api/agent/v1/quorums?country=LB&limit=20&cursor= — $0.01 per quorum returned.
GET /api/agent/v1/quorums/{quorum_id} — $0.01. One quorum and its viewpoints.
GET /api/agent/v1/events?stream=alpha&country=LB&cell=sv8s — $0.02 per alpha event returned.
GET /api/agent/v1/events?stream=news&country=LB — $0.005 per news event returned.
GET /api/agent/v1/articles/{article_id} — $0.005. One article and the quorums on it.
What a quorum contains
viewpoints[] has a label, a summary, support_count, and support_by_source split into media, socials, and iWitness. confidence is a 0–1 score of how well sourced that viewpoint is. Alpha events include quorum when the signal is a quorum topic. News events and articles include quorums.
country is an ISO alpha-2 code. cell is a geohash of precision 3, 4, or 5. Precision 4 is about 40 km by 20 km and applies to alpha. cursor is opaque. Pass next_cursor back to page older events. An empty page is free. A missing quorum or article is a 404 and is not charged.
x402
Unpaid calls return HTTP 402. The PAYMENT-REQUIRED header is a Base64 JSON object with scheme: exact, network eip155:8453 (Base), asset USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and payTo 0x9ce92953d33237af061c6b1aa29c597c8656b547. The amount is the events on that page, in atomic USDC (6 decimals).
Retry the same request with PAYMENT-SIGNATURE set to the Base64 payment payload. A valid payment is settled before the body is returned. The receipt is the PAYMENT-RESPONSE header. A facilitator timeout returns 402 and no events.
Every 402 carries the bazaar extension, so a facilitator that settles one of these calls can list the route. Docs for agents to copy are this page and /llms.txt.