Get Account
Endpoint
Section titled “Endpoint”GET /api/account/latest/v1Description
Section titled “Description”Gives most recent coldkey balance (from the database)
Parameters
Section titled “Parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | query | string | SS58 or hex format | |
balance_free_min | query | string | Min free balance in rao | |
balance_free_max | query | string | in rao | |
balance_staked_min | query | string | in rao | |
balance_staked_max | query | string | in rao | |
balance_staked_root_min | query | string | ||
balance_staked_root_max | query | string | ||
balance_staked_alpha_as_tao_min | query | string | ||
balance_staked_alpha_as_tao_max | query | string | ||
balance_total_min | query | string | in rao | |
balance_total_max | query | string | in rao | |
rank | query | integer | ||
created_on_network | query | string | finney, nakamoto, kusanagi | |
created_on_timestamp_start | query | integer | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
created_on_timestamp_end | query | integer | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
page | query | integer | Page of entries to retrieve. | |
limit | query | integer | Number of entries to return. Max value is 200. | |
order | query | — |
Responses
Section titled “Responses”200 — Accounts retrieved successfully
Section titled “200 — Accounts retrieved successfully”Media: application/json
Schema
{ "type": "object", "required": [ "pagination", "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "address", "network", "block_number", "timestamp", "rank", "balance_free", "balance_staked", "balance_staked_alpha_as_tao", "balance_staked_root", "root_claim_type", "balance_liquidity", "balance_total", "balance_reserved", "created_on_date", "created_on_network" ], "properties": { "address": { "type": "object", "required": [ "ss58", "hex" ], "properties": { "hex": { "type": "string", "description": "The hex format of the hot key" }, "ss58": { "type": "string", "description": "The SS58 format of the hot key" } } }, "alpha_balances": { "type": "array", "items": { "type": "object", "required": [ "balance", "balance_as_tao", "hotkey", "coldkey", "netuid" ], "properties": { "balance": { "type": "string" }, "balance_as_tao": { "type": "string" }, "coldkey": { "type": "string" }, "hotkey": { "type": "string" }, "netuid": { "type": "integer", "format": "int32" } } }, "nullable": true }, "alpha_balances_24hr_ago": { "type": "array", "items": { "type": "object", "required": [ "balance", "balance_as_tao", "hotkey", "coldkey", "netuid" ], "properties": { "balance": { "type": "string" }, "balance_as_tao": { "type": "string" }, "coldkey": { "type": "string" }, "hotkey": { "type": "string" }, "netuid": { "type": "integer", "format": "int32" } } }, "nullable": true }, "balance_free": { "type": "string" }, "balance_free_24hr_ago": { "type": "string", "nullable": true }, "balance_liquidity": { "type": "string" }, "balance_liquidity_24hr_ago": { "type": "string", "nullable": true }, "balance_reserved": { "type": "string" }, "balance_reserved_24hr_ago": { "type": "string", "nullable": true }, "balance_staked": { "type": "string" }, "balance_staked_24hr_ago": { "type": "string", "nullable": true }, "balance_staked_alpha_as_tao": { "type": "string" }, "balance_staked_alpha_as_tao_24hr_ago": { "type": "string", "nullable": true }, "balance_staked_root": { "type": "string" }, "balance_staked_root_24hr_ago": { "type": "string", "nullable": true }, "balance_total": { "type": "string" }, "balance_total_24hr_ago": { "type": "string", "nullable": true }, "block_number": { "type": "integer", "format": "int32" }, "coldkey_swap": { "allOf": [ { "type": "object", "required": [ "old_coldkey", "new_coldkey", "network", "block_number", "timestamp" ], "properties": { "block_number": { "type": "integer", "format": "int32" }, "network": { "type": "string" }, "new_coldkey": { "type": "object", "required": [ "ss58", "hex" ], "properties": { "hex": { "type": "string", "description": "The hex format of the hot key" }, "ss58": { "type": "string", "description": "The SS58 format of the hot key" } } }, "old_coldkey": { "type": "object", "required": [ "ss58", "hex" ], "properties": { "hex": { "type": "string", "description": "The hex format of the hot key" }, "ss58": { "type": "string", "description": "The SS58 format of the hot key" } } }, "timestamp": { "type": "string", "format": "date-time" } } } ], "nullable": true }, "created_on_date": { "type": "string", "format": "date" }, "created_on_network": { "type": "string" }, "network": { "type": "string" }, "rank": { "type": "integer", "format": "int32" }, "root_claim_type": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" } } } }, "pagination": { "type": "object", "required": [ "current_page", "per_page", "total_items", "total_pages" ], "properties": { "current_page": { "type": "integer", "format": "int32" }, "next_page": { "type": "integer", "format": "int32", "nullable": true }, "per_page": { "type": "integer", "format": "int32" }, "prev_page": { "type": "integer", "format": "int32", "nullable": true }, "total_items": { "type": "integer", "format": "int32" }, "total_pages": { "type": "integer", "format": "int32" } } } }}Examples
{ "Result": { "value": "{\n \"pagination\": {\n \"current_page\": 1,\n \"per_page\": 50,\n \"total_items\": 205362,\n \"total_pages\": 4108,\n \"next_page\": 2,\n \"prev_page\": null\n },\n \"data\": [\n {\n \"address\": {\n \"ss58\": \"5GBnPzvPghS8AuCoo6bfnK7JUFHuyUhWSFD4woBNsKnPiEUi\",\n \"hex\": \"0xb656ef6d8fa3ae7a7800906b6ea83a7c1320041290002c3ae7b1e4c68b1e4a67\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 1,\n \"balance_free\": \"777150581296935\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"777150581296935\",\n \"created_on_date\": \"2024-04-09\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FCY9iJYwghetXjE6xiYTj9g3HVW2K7E6JswWnR7PosJCRK9\",\n \"hex\": \"0x8aadfd659682487db6cb8e41e827056374743295cfad120270bc151e20883324\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 2,\n \"balance_free\": \"1647950000\",\n \"balance_staked\": \"239843703109925\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"239843703109925\",\n \"balance_total\": \"239845351059925\",\n \"created_on_date\": \"2025-01-24\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FRqwexkxqXLg4frDhGKM6rCw2y32JWojQ6JV6zBgzhnhq7r\",\n \"hex\": \"0x94d412dc09782a38b2dd3fef97b96b8245b1b96843559fe89592c88ed3bb6531\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 3,\n \"balance_free\": \"15403864982\",\n \"balance_staked\": \"201645972102513\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"201645972102513\",\n \"balance_total\": \"201661375967495\",\n \"created_on_date\": \"2023-02-04\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5EU92KqB1wwvkHonEzZktPRt7FxkUxPa9vY5kgNtJSCr39hs\",\n \"hex\": \"0x6a57d4453c26629b4105379402cb7d5c9224f50576a1c5c1611b8acd26f9e168\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 4,\n \"balance_free\": \"29898768851\",\n \"balance_staked\": \"150849322398475\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"150849322398475\",\n \"balance_total\": \"150879221167326\",\n \"created_on_date\": \"2023-11-25\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5HiveMEoWPmQmBAb8v63bKPcFhgTGCmST1TVZNvPHSTKFLCv\",\n \"hex\": \"0xfa538a1f58eb874d88632a329bc3e6423be5f7da88c1133e4b4d5ed1f3f1ce05\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 5,\n \"balance_free\": \"49998800000\",\n \"balance_staked\": \"145039211117850\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"145039211117850\",\n \"balance_total\": \"145089209917850\",\n \"created_on_date\": \"2022-10-30\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FqBL928choLPmeFz5UVAvonBD5k7K2mZSXVC9RkFzLxoy2s\",\n \"hex\": \"0xa69ffb8d15b780999fc0ae940aabf71073498ab19a1561a4c4b473ebbe8a336a\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 6,\n \"balance_free\": \"142160576320779\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"142160576320779\",\n \"created_on_date\": \"2023-03-02\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5HbDZ6ULuwZegAMSPaS2kaUfBLMDaht5t48RcDrQATSgGCAR\",\n \"hex\": \"0xf4727f994265ec96f5cfc2222ee6aac87025293a794c9160ef176817e98a676c\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 7,\n \"balance_free\": \"120996357777962\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"120996357777962\",\n \"created_on_date\": \"2023-03-30\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5Cpg8kw41wfBhs6L3weZhAPq5f2648yyqRUGXt2ePFU2WRdg\",\n \"hex\": \"0x2188ffbfdfc7b9846427e1e2d69fbc4a5274dae7cdb5edaec6f064bec7e382e9\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 8,\n \"balance_free\": \"105255438958345\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"105255438958345\",\n \"created_on_date\": \"2024-09-30\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5HkG3knAbnxDmaQ2HrhxygJjHqBudt3XXgW6fZ8VuMTX8vdv\",\n \"hex\": \"0xfb581a65c807b89e7e015638812c7f8181fd0aced27dac73a136517ed8cb4e95\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 9,\n \"balance_free\": \"96285071000000\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"96285071000000\",\n \"created_on_date\": \"2025-02-11\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5C5FQQSfuxgJc5sHjjAL9RKAzR98qqCV2YN5xAm2wVf1ctGR\",\n \"hex\": \"0x006a327fd8209758351b989bc48825c945360dcc1d7ac279976cd445d9027d03\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 10,\n \"balance_free\": \"85445999022372\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"85445999022372\",\n \"created_on_date\": \"2024-07-12\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5E2b2DcMd5W8MBhzTCFt63t2ZEN8RsRgL7oDd7BFYL9aMQux\",\n \"hex\": \"0x56daf75bd0f09c11d798263bc79baeb77c4b4af1dbd372bbe532b1f8702b2a7e\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 11,\n \"balance_free\": \"69993192164004\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"69993192164004\",\n \"created_on_date\": \"2024-06-20\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5DgxQoLKBimYrb1SbXkaLyd4YyBJueVGRMkUDjHgmGuNr84c\",\n \"hex\": \"0x47e20fa2cf004f41ff383554275fb4f7378d801d322681d3cc2914464d786e72\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 12,\n \"balance_free\": \"1271949413\",\n \"balance_staked\": \"66144451433684\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"66144451433684\",\n \"balance_total\": \"66145723383097\",\n \"created_on_date\": \"2025-01-31\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FtD2tAByR3GfDe6F6mPkq9pB93Mp42AP3Y7DEfozScXAE11\",\n \"hex\": \"0xa8ef732bf3421519333bfc0394604477403e2cabd874d1687612805f65a53813\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 13,\n \"balance_free\": \"66099929445569\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"66099929445569\",\n \"created_on_date\": \"2024-10-24\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FZ3kzkS3tC1DfY3f4k6TY9Jd8cPVTAJpxDWEo5sYo6a3pBa\",\n \"hex\": \"0x9a5291870097ef2f8eb6f2f30501f9ffc7335ecd4bdd411b8cca5cb0d44d6020\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 14,\n \"balance_free\": \"656451861\",\n \"balance_staked\": \"62064362500212\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"62064362500212\",\n \"balance_total\": \"62065018952073\",\n \"created_on_date\": \"2023-04-18\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5DyMLUKuc6T3QFAXKd3w6dTcxmcH1WBZ1gDrRwJAnPf7N28w\",\n \"hex\": \"0x546329490cb14895d40150b0b0da6dbbbff19cd36eaa8d12a37f21f842fb1153\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 15,\n \"balance_free\": \"2088698628\",\n \"balance_staked\": \"61874203161099\",\n \"balance_staked_alpha_as_tao\": \"425046032841\",\n \"balance_staked_root\": \"61449157128258\",\n \"balance_total\": \"61876291859727\",\n \"created_on_date\": \"2022-12-15\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5EFmtbmZ45HMRbrZpppoB1kzArMfNwBYN3KWNguq6jXtmLC3\",\n \"hex\": \"0x60e9be606b84aabddf41d6206269bf3dbe5b10ab1af3bbd206caa622be437b21\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 16,\n \"balance_free\": \"380769\",\n \"balance_staked\": \"60712853298506\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"60712853298506\",\n \"balance_total\": \"60712853679275\",\n \"created_on_date\": \"2024-07-13\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": {\n \"old_coldkey\": {\n \"ss58\": \"5FP8V4zuA2g2Mn1vaCcftPMp41uSwvNX6VzzTE7gqQ5t1dAS\",\n \"hex\": \"0x92c20583b2fc1ffbfbc1050d763579185c4a2218c73d9aa619dfbf940e139e4c\"\n },\n \"new_coldkey\": {\n \"ss58\": \"5EFmtbmZ45HMRbrZpppoB1kzArMfNwBYN3KWNguq6jXtmLC3\",\n \"hex\": \"0x60e9be606b84aabddf41d6206269bf3dbe5b10ab1af3bbd206caa622be437b21\"\n },\n \"network\": \"finney\",\n \"block_number\": 3374016,\n \"timestamp\": \"2024-07-13T02:25:00Z\"\n }\n },\n {\n \"address\": {\n \"ss58\": \"5EprSTPWJByh3GBKwkMz2TnbSapgbkRM6UUDkGcwx1gVg4bn\",\n \"hex\": \"0x7a2427f542d6a923c70a1544d6c8cbbe1a4e4eaa17162989888ffca35979b15b\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 17,\n \"balance_free\": \"12331953\",\n \"balance_staked\": \"60035584293428\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"60035584293428\",\n \"balance_total\": \"60035596625381\",\n \"created_on_date\": \"2021-11-03\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5GHHbDPmpongnDacuySCUDkNt3MMkBbFGS7FCvmTj1if37bZ\",\n \"hex\": \"0xba896f978f18d179207937a73758022ff6b405bc8ac519c5ab9874a89078dc18\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 18,\n \"balance_free\": \"51304254965530\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"51304254965530\",\n \"created_on_date\": \"2024-11-22\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5HaPLYrMSNsYVRVhxyCpZdgEsvKR6NkVFmC33mHDunyj1Aqy\",\n \"hex\": \"0xf3d0301ae9c14a61732c7871e8d91ae711c4da7c974c53520722a3e63cec9ecd\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 19,\n \"balance_free\": \"499726770\",\n \"balance_staked\": \"51099719721941\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"51099719721941\",\n \"balance_total\": \"51100219448711\",\n \"created_on_date\": \"2025-01-15\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5Ext1B4v7mJAsxQrHmMxU1oQxbTnXkg4j6h5wGHHZCYNwULC\",\n \"hex\": \"0x80436275057d21c9786a129cf8be93f11530ef8c8a89d44add62db092c16a76e\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 20,\n \"balance_free\": \"500\",\n \"balance_staked\": \"45436325843628\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"45436325843628\",\n \"balance_total\": \"45436325844128\",\n \"created_on_date\": \"2024-07-13\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": {\n \"old_coldkey\": {\n \"ss58\": \"5EA1W6o97C6G8uhawC5MxHrYtiE7bTSsrA9Rg2uRbb4eWUF8\",\n \"hex\": \"0x5c8417f41f1602a9bfd961dbe3a866efce3d5e28c126db9f82b429f2b0219e4d\"\n },\n \"new_coldkey\": {\n \"ss58\": \"5Ext1B4v7mJAsxQrHmMxU1oQxbTnXkg4j6h5wGHHZCYNwULC\",\n \"hex\": \"0x80436275057d21c9786a129cf8be93f11530ef8c8a89d44add62db092c16a76e\"\n },\n \"network\": \"finney\",\n \"block_number\": 3373593,\n \"timestamp\": \"2024-07-13T00:51:12Z\"\n }\n },\n {\n \"address\": {\n \"ss58\": \"5FuybSNhwoMcQmSi5nSrmEUbKWbSew8fSPKfGXQZbhVJkNJX\",\n \"hex\": \"0xaa48b3b686dceb4bb56234e49ce5d6e05ecbce7986ec7f30828106ac901a6438\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 21,\n \"balance_free\": \"1863944466\",\n \"balance_staked\": \"45125347146931\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"45125347146931\",\n \"balance_total\": \"45127211091397\",\n \"created_on_date\": \"2024-09-06\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5CVSCaCXDRydd3Mkdbu2tHLNYxmNTSpy9yRixa1TRGvgRFS8\",\n \"hex\": \"0x12dc6df75ad35fb5b75af3aec0c99b3c4267f9463353d6d9c487c01e129aec73\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 22,\n \"balance_free\": \"45052356499832\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"45052356499832\",\n \"created_on_date\": \"2024-07-23\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5H9brHhMA1km3Dp3YCx75oaimgxEYScxCfxbzQRZ3gHk9x3L\",\n \"hex\": \"0xe0e92ca738afe2956313c455dd627652b7028f6c650cd2379f9e832c3ce0ca7e\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 23,\n \"balance_free\": \"40829267363051\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"40829267363051\",\n \"created_on_date\": \"2024-10-10\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5FsWP1GxpzT11xyFBojKpE75pzp54ESDA6BYbRMPJ2nsCZE5\",\n \"hex\": \"0xa8669978e6f75c3e52c1a89f810693ee9a64ff886a99b333e5c07ef990b05ca3\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 24,\n \"balance_free\": \"40786545987720\",\n \"balance_staked\": \"0\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"0\",\n \"balance_total\": \"40786545987720\",\n \"created_on_date\": \"2023-09-06\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5Gn9nv7Le5XYitfP86bdDuc92fUtcPGQtDM6vCcZur4fwUpy\",\n \"hex\": \"0xd08d4d296645d89cd18039085fdc6e9aced898653b188fb88b8d001a06a0f91c\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 25,\n \"balance_free\": \"100001000\",\n \"balance_staked\": \"39957473722123\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"39957473722123\",\n \"balance_total\": \"39957573723123\",\n \"created_on_date\": \"2024-07-13\",\n \"created_on_network\": \"finney\",\n \"coldkey_swap\": {\n \"old_coldkey\": {\n \"ss58\": \"5ES7RB2Qm45CwMNDZkTvfF2LxXPRtjzAdwHafrocftsTt1xy\",\n \"hex\": \"0x68cbee8f304e12c666b10c29baf749f7e5d675d6cc24a106e3e4922aedb55d02\"\n },\n \"new_coldkey\": {\n \"ss58\": \"5Gn9nv7Le5XYitfP86bdDuc92fUtcPGQtDM6vCcZur4fwUpy\",\n \"hex\": \"0xd08d4d296645d89cd18039085fdc6e9aced898653b188fb88b8d001a06a0f91c\"\n },\n \"network\": \"finney\",\n \"block_number\": 3373638,\n \"timestamp\": \"2024-07-13T01:01:00.001Z\"\n }\n },\n {\n \"address\": {\n \"ss58\": \"5GFBZdnVVA8yhzYVLzvZ1CyRrSkB32VGaDKBk8o8u7MwziQQ\",\n \"hex\": \"0xb8eea7d71f0f601470ad81829c8debb7753b39b73655a1ea2e437fa044fd1121\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"timestamp\": \"2025-02-26T13:52:48Z\",\n \"rank\": 26,\n \"balance_free\": \"856287732\",\n \"balance_staked\": \"39530750887161\",\n \"balance_staked_alpha_as_tao\": \"0\",\n \"balance_staked_root\": \"39530750887161\",\n \"balance_total\": \"39531607174893\",\n \"created_on_date\": \"2021-11-02\",\n \"created_on_network\": \"nakamoto\",\n \"coldkey_swap\": null\n },\n {\n \"address\": {\n \"ss58\": \"5Gp6mLi4sCkyKicB7hJbkCZ53oJvWqdgQ7AqBykmWKTx7Ry1\",\n \"hex\": \"0xd2099a1358f5d6fc5537c5fa1506acfcf70beff693aa8df2ff708c00dd7d0269\"\n },\n \"network\": \"finney\",\n \"block_number\": 5011596,\n \"
/* … truncated, full schema in /api/openapi.json */400 — Bad request
Section titled “400 — Bad request”404 — Accounts not found
Section titled “404 — Accounts not found”500 — Internal server error
Section titled “500 — Internal server error”Try it
Section titled “Try it”Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).
Authentication
Section titled “Authentication”All Taostats API requests require an Authorization header containing your API key. See Getting Started.