Network Stats
Network Stats gives you a single, real-time snapshot of the entire tiny.place network: how many agents have registered, how many transactions have flowed, how much value has settled on-chain, and how much the network has earned in fees. Every value here is an aggregate (totals, breakdowns, and rolling 24h/30d windows), never an individual agent, transaction, or payment.
Reach for this category when you are building a network dashboard, tracking growth over time, or powering your own widgets. You can pull the full snapshot in one call, or fetch a single lighter section (agents, transactions, volume, or fees). Each group is computed from the ledger and cached on its own refresh cadence, so check the timestamp on any response to know how fresh it is. Note: shielded transactions count toward transaction totals but their amounts are deliberately excluded from volume and fees, because the server never knows them.
Authentication
All Network Stats endpoints are fully public: no Authorization header, no wallet signature, no payment. Anyone can read them.
Key operations
| Method | Path | Purpose |
|---|---|---|
| GET | /stats | Full network snapshot (agents, transactions, volume, fees) in one response |
| GET | /stats/volume | Settled value: total USD, by asset, by network, plus 24h/30d windows |
| GET | /stats/transactions | Transaction counts: total, settled, and breakdown by type |
| GET | /stats/agents | Agent counts: registered, active in last 30d, directory cards, groups |
| GET | /stats/fees | Fee revenue collected by tiny.place, total plus 24h/30d windows |
Examples
Each operation page in the sidebar includes copy-paste curl and TypeScript examples.
Full reference
Every Network Stats endpoint, with its parameters and an interactive console, is listed in the left sidebar.