Documentation / New API reference / Accounts
Get Accounts Address Identity
Reference
Last reviewed 2026-10-07
One wallet's on-chain identity, as a single-element data array. 404 when the coldkey has no identity on chain now, including one that was removed.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | SS58 or 0x-hex coldkey |
Responses
200 — The wallet's on-chain identity
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].additional | string, nullable | Yes | The identity's free-form additional field. |
data[].address | string | Yes | The coldkey the identity belongs to (SS58). |
data[].description | string, nullable | Yes | Description. |
data[].discord | string, nullable | Yes | Discord, as set on chain. |
data[].github_repo | string, nullable | Yes | GitHub repository, as set on chain. |
data[].image | string, nullable | Yes | Image URL, as set on chain. |
data[].name | string, nullable | Yes | Display name. null when the identity sets none. |
data[].url | string, nullable | Yes | Website, as set on chain. |
data[].validator_hotkeys | array | Yes | Hotkeys this coldkey owns that are validators today (the owner /v1/validators shows), sorted. Empty when it owns none. |
data[].validator_hotkeys[] | string | Yes |
400 — Invalid address
| 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). |
404 — The wallet has no on-chain identity
| 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.