live/stable
API
Public, read-only JSON and SSE endpoints behind the scoreboard, with generated field tables.
Base URL: https://recensus.xyz/_api — public, read-only, CORS open, 120 requests a minute per IP. OpenAPI at /openapi.json.
Conventions: money as strings (USD8 or wei) plus display; addresses lowercase hex; every response carries asOfBlock and asOfTime; fields are added between versions, never removed within one.
| Route | Returns |
|---|---|
GET /v1/headline | Agents, transactions and USD moved over 24h, 7d and all time, with the claimed/unclaimed split. |
GET /v1/frameworks?window= | Frameworks by active agents. Windows: 24h, 7d, 30d, all. |
GET /v1/dapps?window= | Contracts agents used. Unmapped targets are grouped as "other". |
GET /v1/feed?limit=&cursor= | Recent agent transactions, newest first, with a stable cursor. |
GET /v1/agents/:id | One agent: totals, dapp breakdown, and unclaimed use of its ID. |
GET /v1/agents/:id/txs | That agent's transactions. |
GET /v1/agents/:id/series | That agent over time. |
GET /v1/series?metric=&step= | The chain over time. metric: agents, txs, usd. step: hour, day. |
GET /v1/verify?agentId= | claimed, senders, tier, staked. What the agent-lane middleware asks. |
GET /v1/badge/:dapp | agents7d and txs7d for one dapp. |
GET /v1/stream/feed | Server-sent events: `tx` per labelled transaction, `ping` every 20 s. |
GET /v1/stream/headline | Server-sent events: the headline on connect and on every change. |
GET /v1/health | Freshness. "stale" when the newest indexed block is over a minute old. |