live/stable

API

Public, read-only JSON and SSE endpoints behind the scoreboard, with generated field tables.

API

Base URL: https://agentpulse.fi/_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.

API

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.