Documentation / API reference / Subnet
Get Subnet Coldkey Distribution
Reference
Last reviewed 2026-09-18
Returns the distribution of subnet hotkeys across coldkeys as counts per coldkey. Supply a netuid to inspect ownership concentration; the counts are not stake balances.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Yes | Subnet |
Responses
200 — Subnet coldkey distribution retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].coldkey | string | Yes |
data[].count | integer (int32) | Yes |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{
"data": [
{
"coldkey": "5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC",
"count": 1
},
{
"coldkey": "5GZSAgaVGQqegjhEkxpJjpSVLVmNnE2vx2PFLzr7kBBMKpGQ",
"count": 1
}
],
"pagination": {
"current_page": 1,
"next_page": null,
"per_page": 42,
"prev_page": null,
"total_items": 42,
"total_pages": 1
}
}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Subnet coldkey distribution not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.