Documentation / New API reference / Network
Get Network Stats
GET /v1/network/stats — Taostats API endpoint in the Network group.
Reference
Last reviewed 2026-10-07
Latest snapshot.
Try it
Parameters
No parameters.
Responses
200 — Latest network-wide statistics
| Field | Type | Required | Description |
|---|---|---|---|
data | object | Yes | One row of network-wide statistics. |
data.accounts | integer (int64) | Yes | Total accounts. |
data.balance_holders | integer (int64) | Yes | Accounts with balance. |
data.block_number | integer (int32) | Yes | Block height. |
data.extrinsics | integer (int64) | Yes | Total extrinsics. |
data.free | string | Yes | Circulating supply (RAO, u64 as string). |
data.issued | string | Yes | Total issued (RAO, u64 as string). |
data.staked | string | Yes | Total staked (RAO, u64 as string). |
data.staked_alpha | string, nullable | Total staked alpha (RAO, u64 as string). null pre-dTAO. | |
data.staked_root | string, nullable | Root stake the stakers hold, TotalHotkeyAlpha(_, 0) summed (RAO, u64 as string) — not the root pool's reserve, so it need not add up with staked_alpha to staked (#827). null pre-dTAO. | |
data.subnet_locked | string | Yes | Total subnet locked (RAO, u64 as string). |
data.subnets | integer (int64) | Yes | Total subnets. |
data.timestamp | string | Yes | ISO 8601 timestamp with millisecond precision. |
data.transfers | integer (int64) | Yes | Total transfers. |
404 — No data yet
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
500 — Internal server error
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.