Documentation / API reference / Identity
Get On Chain Identity
Reference
Last reviewed 2026-09-18
Returns the latest account identities, including names, descriptions, images and contact links.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | query | string | SS58 or hex format | |
validator_hotkey | query | string | SS58 or hex format | |
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, |
Responses
200 — Identity retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].additional | string, nullable | ||
data[].address | object | Yes | |
data[].address.hex | string | Yes | The hex format of the hot key |
data[].address.ss58 | string | Yes | The SS58 format of the hot key |
data[].description | string, nullable | ||
data[].discord | string, nullable | ||
data[].github_repo | string, nullable | ||
data[].image | string, nullable | ||
data[].name | string, nullable | ||
data[].url | string, nullable | ||
data[].validator_hotkey | object, nullable | ||
data[].validator_hotkey.hex | string | Yes | The hex format of the hot key |
data[].validator_hotkey.ss58 | string | Yes | The SS58 format of the hot key |
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": [
{
"description": "Secure and maintain Bittensor",
"hotkey": {
"hex": "0x12dc421c6e53de8161d0b7a3d1f5377f9044d9f324f98249ca538e92dc90e27e",
"ss58": "5CVS9d1NcQyWKUyadLevwGxg6LgBcF9Lik6NSnbe5q59jwhE"
},
"name": "Ary van der Touw",
"signature": "809586931d4b28f180c98036a3eebc0d26b9e521f5217a6942b025069cb60807641737009713446eec8456e54ba753ae0b752c0693b942aefa0c4f76d82f8c89",
"url": ""
},
{
"description": "Premier Bittensor Multi-Subnet Validator from a company operating validating and mining infrastructure on various blockchain networks. We have been active on Bittensor since November 2022, with near zero down-time. More information at https://athenanodes.com/.",
"hotkey": {
"hex": "0x167e725947357c355af0f3e9e934db1045fb82bdfeee6a72061e81facf958462",
"ss58": "5CaCUPsSSdKWcMJbmdmJdnWVa15fJQuz5HsSGgVdZffpHAUa"
},
"name": "Athena Nodes",
"signature": "2ef54045de1d9b89988518c92e165edf704192f88f18022565f497b389c39206f621bb9bc6d2d33ac8a9cca05d6b2d8fc9f899b390451140968b15b8d9c13280",
"url": "https://athenanodes.com"
}
],
"pagination": {
"current_page": 1,
"next_page": null,
"per_page": 100,
"prev_page": null,
"total_items": 60,
"total_pages": 1
}
}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Identity not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.