Skip to content
Taostats Docs

Get dTao Stake Balance

Endpoint

Section titled “Endpoint”
GET /api/dtao/stake_balance/latest/v1

Parameters

Section titled “Parameters”
NameInTypeRequiredDescription
coldkeyquerystringSS58 or hex format
hotkeyquerystringSS58 or hex format
netuidqueryintegerSubnet
balance_minquerystringin nanoAlpha
balance_maxquerystringin nanoAlpha
balance_as_tao_minquerystringin rao
balance_as_tao_maxquerystringas rao
pagequeryintegerThe page number of the response.
limitqueryintegerThe number of responses. max is 200,
orderquery—

Responses

Section titled “Responses”

200 — Stake balances retrieved successfully

Section titled “200 — Stake balances retrieved successfully”

Media: application/json

Schema
{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "hotkey",
          "coldkey",
          "netuid",
          "subnet_rank",
          "subnet_total_holders",
          "balance",
          "balance_as_tao"
        ],
        "properties": {
          "balance": {
            "type": "string"
          },
          "balance_as_tao": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "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"
              }
            }
          },
          "hotkey": {
            "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"
              }
            }
          },
          "hotkey_name": {
            "type": "string",
            "nullable": true
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "subnet_rank": {
            "type": "integer",
            "format": "int32"
          },
          "subnet_total_holders": {
            "type": "integer",
            "format": "int32"
          },
          "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\": 115756,\n    \"total_pages\": 2316,\n    \"next_page\": 2,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"TAO.app\",\n      \"hotkey\": {\n        \"ss58\": \"5CoZxgtfhcJKX2HmkwnsN18KbaT9aih9eF3b6qVPTgAUbifj\",\n        \"hex\": \"0x20b0f8ac1d5416d32f5a552f98b570f06e8392ccb803029e04f63fbe0553c954\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5HqaAYanMmQUh6agtnsXeWcHJDsoBF4eWwAkUPV7WEG3zZqW\",\n        \"hex\": \"0xff65514f004c0bc475af33c478c36c2fe74c7e3d107937a0b74e781de7d4cfa1\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 86,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"13728596610703\",\n      \"balance_as_tao\": \"13728596610703\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Rizzo (Insured)\",\n      \"hotkey\": {\n        \"ss58\": \"5F2CsUDVbRbVMXTh9fAzF9GacjVX7UapvRxidrxe7z8BYckQ\",\n        \"hex\": \"0x82cca2238d379e49d84e9e1b8df35dd496d6a8b4ca4f511ac9e38fa04d42f86b\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5EqUG3oUuzT5siNv5bSE9PKzqp8t2ehYEX7SeEjTjymuJS9W\",\n        \"hex\": \"0x7a9cbd27dd53d8020edb9db0a18c7603d12f8b64db91da1ce2d3909071a29656\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 122,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"8969717622045\",\n      \"balance_as_tao\": \"8969717622045\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Open\u03c4ensor Founda\u03c4ion\",\n      \"hotkey\": {\n        \"ss58\": \"5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3\",\n        \"hex\": \"0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DrFtXthmP6oNdJDGLhWZ6nTcFcFdsefRjpX8avqCPAtxXgi\",\n        \"hex\": \"0x4efa1b42105e1dc9c709b475edee61f742fa4dd2eb638da71321519185f6e247\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 142,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"7131742665504\",\n      \"balance_as_tao\": \"7131742665504\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": null,\n      \"hotkey\": {\n        \"ss58\": \"5G1NjW9YhXLadMWajvTkfcJy6up3yH2q1YzMXDTi6ijanChe\",\n        \"hex\": \"0xae66d26fed539fc501b4340faaef65e20feb0dbf388658997c034babad06bf43\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Esep5aweB67jGDSD6QmN78Qx4kj73TSku2q5osZWEUuxRNj\",\n        \"hex\": \"0x7c46c072e3337817886c3ba7ce5bea8d0712e3e31cadcbda988f94b961f6cc78\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 0,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"6947449082394\",\n      \"balance_as_tao\": \"6947449082394\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Tatsu\",\n      \"hotkey\": {\n        \"ss58\": \"5D4gEn5S422dTGR5NJJKZ93FNV6hDmfwDPfxFNgcoVnUkZ4f\",\n        \"hex\": \"0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5EqUG3oUuzT5siNv5bSE9PKzqp8t2ehYEX7SeEjTjymuJS9W\",\n        \"hex\": \"0x7a9cbd27dd53d8020edb9db0a18c7603d12f8b64db91da1ce2d3909071a29656\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 187,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"4539057654826\",\n      \"balance_as_tao\": \"4539057654826\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao.bot\",\n      \"hotkey\": {\n        \"ss58\": \"5E2LP6EnZ54m3wS8s1yPvD5c3xo71kQroBw7aUVK32TKeZ5u\",\n        \"hex\": \"0x56a9aee6291bd03ab6d36d4d13e2bebae7cd403518066c72fba1b417d6ddd748\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5GF1rRs86PnQD74hA22r7UZoTwHrotYK8hYiJ8E9RQXVfGAs\",\n        \"hex\": \"0xb8cdf7a5a607d0bea9348a135b5f8529dd46316de208d946e6ff44ed1dedeb34\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 195,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"4292859509308\",\n      \"balance_as_tao\": \"4292859509308\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"TaoBee\",\n      \"hotkey\": {\n        \"ss58\": \"5G9hfkx9wGB1CLMT9WXkpHSAiYzjZb5o1Boyq4KAdDhjwrc5\",\n        \"hex\": \"0xb4c087119097fbe3985298eef52f35ef6271c48322a8c2d430902a9cc38d9473\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5EFNRp6UUcUmLynPZNCwsPFrPVUqP2Qzit9gcHyqZ6kivmq4\",\n        \"hex\": \"0x609ac396e0883080ca8c0bf0bf7427c92e80b0243d2ecb7eb97f3f413971f300\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 205,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"3989658634951\",\n      \"balance_as_tao\": \"3989658634951\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Taostats & Corcel\",\n      \"hotkey\": {\n        \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n        \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5G7FbwoHdmqiCPvY8uFS4fp3KGDSdvTcT9Uwk9fwLPcEw4kJ\",\n        \"hex\": \"0xb2e24aaca781c3c4c9ff8e5c665a2666de75ab3ec8e571ec411dbcb313bbb026\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 231,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"3266185162139\",\n      \"balance_as_tao\": \"3266185162139\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"TaoBee\",\n      \"hotkey\": {\n        \"ss58\": \"5G9hfkx9wGB1CLMT9WXkpHSAiYzjZb5o1Boyq4KAdDhjwrc5\",\n        \"hex\": \"0xb4c087119097fbe3985298eef52f35ef6271c48322a8c2d430902a9cc38d9473\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DdALs6w9p4xtnp9HHV49UqUcrrB8EeKpTx8wfqs3eCTrUon\",\n        \"hex\": \"0x44fd3f2613401dd2f928ef46be57704b09ddfb64bdd642c336b3ffe659fdced6\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 233,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"3262295720312\",\n      \"balance_as_tao\": \"3262295720312\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Open\u03c4ensor Founda\u03c4ion\",\n      \"hotkey\": {\n        \"ss58\": \"5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3\",\n        \"hex\": \"0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Gis7zonfnrAZ9U4jeHA6t1pAmdUYFJbiJyANuPPyLw42Wnm\",\n        \"hex\": \"0xce0b720fbd633da8d829da68c0fa23a9d6775e6ce5e4b5b8803104beede0c401\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 248,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"3039996805426\",\n      \"balance_as_tao\": \"3039996805426\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Tatsu\",\n      \"hotkey\": {\n        \"ss58\": \"5D4gEn5S422dTGR5NJJKZ93FNV6hDmfwDPfxFNgcoVnUkZ4f\",\n        \"hex\": \"0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5ECtU9arSfMntoNHfPHsAJjm1xJimcXwtpSbRHQF5wW7VSzc\",\n        \"hex\": \"0x5eb627032a53cbdefcd57b20c470718035f67f55513ce541736a370650b50e32\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 279,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2635854188905\",\n      \"balance_as_tao\": \"2635854188905\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Ary van der Touw\",\n      \"hotkey\": {\n        \"ss58\": \"5CVS9d1NcQyWKUyadLevwGxg6LgBcF9Lik6NSnbe5q59jwhE\",\n        \"hex\": \"0x12dc421c6e53de8161d0b7a3d1f5377f9044d9f324f98249ca538e92dc90e27e\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DdALs6w9p4xtnp9HHV49UqUcrrB8EeKpTx8wfqs3eCTrUon\",\n        \"hex\": \"0x44fd3f2613401dd2f928ef46be57704b09ddfb64bdd642c336b3ffe659fdced6\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 297,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2501097054650\",\n      \"balance_as_tao\": \"2501097054650\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao.bot\",\n      \"hotkey\": {\n        \"ss58\": \"5E2LP6EnZ54m3wS8s1yPvD5c3xo71kQroBw7aUVK32TKeZ5u\",\n        \"hex\": \"0x56a9aee6291bd03ab6d36d4d13e2bebae7cd403518066c72fba1b417d6ddd748\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DdALs6w9p4xtnp9HHV49UqUcrrB8EeKpTx8wfqs3eCTrUon\",\n        \"hex\": \"0x44fd3f2613401dd2f928ef46be57704b09ddfb64bdd642c336b3ffe659fdced6\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 298,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2501085154397\",\n      \"balance_as_tao\": \"2501085154397\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao5\",\n      \"hotkey\": {\n        \"ss58\": \"5CsvRJXuR955WojnGMdok1hbhffZyB4N5ocrv82f3p5A2zVp\",\n        \"hex\": \"0x2402d2dd859f24ff5305ce12d54e02f3c2cafe6788af4b405bbe0d407695af37\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DdALs6w9p4xtnp9HHV49UqUcrrB8EeKpTx8wfqs3eCTrUon\",\n        \"hex\": \"0x44fd3f2613401dd2f928ef46be57704b09ddfb64bdd642c336b3ffe659fdced6\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 299,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2501005563791\",\n      \"balance_as_tao\": \"2501005563791\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Tatsu\",\n      \"hotkey\": {\n        \"ss58\": \"5D4gEn5S422dTGR5NJJKZ93FNV6hDmfwDPfxFNgcoVnUkZ4f\",\n        \"hex\": \"0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5DdALs6w9p4xtnp9HHV49UqUcrrB8EeKpTx8wfqs3eCTrUon\",\n        \"hex\": \"0x44fd3f2613401dd2f928ef46be57704b09ddfb64bdd642c336b3ffe659fdced6\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 300,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2500998965585\",\n      \"balance_as_tao\": \"2500998965585\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Tatsu\",\n      \"hotkey\": {\n        \"ss58\": \"5D4gEn5S422dTGR5NJJKZ93FNV6hDmfwDPfxFNgcoVnUkZ4f\",\n        \"hex\": \"0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5CQ6dMW8JZhKCZX9kWsZRqa3kZRKmNHxbPPVFEt6FgyvGv2G\",\n        \"hex\": \"0x0eca5097f29744aa664c8fa756e0d97bd46ff0b4823ce08a43a6f27ec863c830\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 318,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2348549298279\",\n      \"balance_as_tao\": \"2348549298279\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao5\",\n      \"hotkey\": {\n        \"ss58\": \"5CsvRJXuR955WojnGMdok1hbhffZyB4N5ocrv82f3p5A2zVp\",\n        \"hex\": \"0x2402d2dd859f24ff5305ce12d54e02f3c2cafe6788af4b405bbe0d407695af37\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5ELpH8nvdnNW33S1ZZfvooU5SCPqPozjjhvy6iVKCVD5LjcB\",\n        \"hex\": \"0x64c202dddfa338fd295dd0551bfeb7bb16b9aa2ea7b43d50ac595f379f87da35\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 329,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"2259291924816\",\n      \"balance_as_tao\": \"2259291924816\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao5\",\n      \"hotkey\": {\n        \"ss58\": \"5CsvRJXuR955WojnGMdok1hbhffZyB4N5ocrv82f3p5A2zVp\",\n        \"hex\": \"0x2402d2dd859f24ff5305ce12d54e02f3c2cafe6788af4b405bbe0d407695af37\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5C5FwRHVfsUUwW65SEAvh7dt7X9NKSLBEvwW1Prd15bUESvz\",\n        \"hex\": \"0x006bff51580067064c6c90c25be1c3d89e7deee3c96c3b467fdc3bd09454a54e\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 438,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1619990103611\",\n      \"balance_as_tao\": \"1619990103611\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"FirstTensor.com\",\n      \"hotkey\": {\n        \"ss58\": \"5DvTpiniW9s3APmHRYn8FroUWyfnLtrsid5Mtn5EwMXHN2ed\",\n        \"hex\": \"0x522f432f51287df57711a3a00f6c7a334b0c813ff178c22649f01566ef4a5d48\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Gq76tSWLgZ5wd9qkYTTDppnF3nUZXKhYMUGLXazdG7Yeed8\",\n        \"hex\": \"0xd2cdfb5535e964d5a43cd5979099b63335739cb2ab09b8786976365c02f4b35b\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 481,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1417494282098\",\n      \"balance_as_tao\": \"1417494282098\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Taostats & Corcel\",\n      \"hotkey\": {\n        \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n        \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5GqFGALA6C3KBnr5wqPAuHz8rVEubxnpiL4aUx9KvxkEE7KP\",\n        \"hex\": \"0xd2e9734f3d9f4f04f45f2b7ec72292e6950c274f51ec39d0129dfbd996462150\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 487,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1394259905326\",\n      \"balance_as_tao\": \"1394259905326\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"RoundTable21\",\n      \"hotkey\": {\n        \"ss58\": \"5FFApaS75bv5pJHfAp2FVLBj9ZaXuFDjEypsaBNc1wCfe52v\",\n        \"hex\": \"0x8cafec513739d2ed72700fe9ef1b4a62c3d0b06ddf6258bb00cbac2cbced5f68\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5EneKvwU8mTxKaopvL34nXqieg6jAasn51vpypKAdGDpnyWg\",\n        \"hex\": \"0x7874e4168897d7a80802fea47534b13b2a2f0db2802c03dc0fac4ca892176a0c\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 489,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1378988357344\",\n      \"balance_as_tao\": \"1378988357344\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Taostats & Corcel\",\n      \"hotkey\": {\n        \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n        \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5CG5k2g9zvAFDw9U1zx4Gm4ss71JSxG68tqF26TqXkDMP2CQ\",\n        \"hex\": \"0x08ad5f6aa837edeafed329f4cc9e97c5fee61557367e950363e98ee9d7f91856\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 548,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1197423132725\",\n      \"balance_as_tao\": \"1197423132725\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Open\u03c4ensor Founda\u03c4ion\",\n      \"hotkey\": {\n        \"ss58\": \"5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3\",\n        \"hex\": \"0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5GGhTZXMFMKbJbymyjv8X3XnXocbQhWBxFKXnAqJHbmLHFVZ\",\n        \"hex\": \"0xba16899ba0a2b032dbafcfdbd8cdaa4044fdd32de704c45af1bcc8982301d326\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 553,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1180337316605\",\n      \"balance_as_tao\": \"1180337316605\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao5\",\n      \"hotkey\": {\n        \"ss58\": \"5CsvRJXuR955WojnGMdok1hbhffZyB4N5ocrv82f3p5A2zVp\",\n        \"hex\": \"0x2402d2dd859f24ff5305ce12d54e02f3c2cafe6788af4b405bbe0d407695af37\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Cw2cjHDoF9ibhznWKqnKouBbraoqR8T1szaBTRicFxm5XKv\",\n        \"hex\": \"0x26616bc081dd088add90e27e2ab26050725d7c68a15caa745a3002b1b75fe6a0\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 580,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1100812693630\",\n      \"balance_as_tao\": \"1100812693630\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"tao5\",\n      \"hotkey\": {\n        \"ss58\": \"5CsvRJXuR955WojnGMdok1hbhffZyB4N5ocrv82f3p5A2zVp\",\n        \"hex\": \"0x2402d2dd859f24ff5305ce12d54e02f3c2cafe6788af4b405bbe0d407695af37\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5G7FbwoHdmqiCPvY8uFS4fp3KGDSdvTcT9Uwk9fwLPcEw4kJ\",\n        \"hex\": \"0xb2e24aaca781c3c4c9ff8e5c665a2666de75ab3ec8e571ec411dbcb313bbb026\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 595,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1077938103310\",\n      \"balance_as_tao\": \"1077938103310\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Rizzo (Insured)\",\n      \"hotkey\": {\n        \"ss58\": \"5F2CsUDVbRbVMXTh9fAzF9GacjVX7UapvRxidrxe7z8BYckQ\",\n        \"hex\": \"0x82cca2238d379e49d84e9e1b8df35dd496d6a8b4ca4f511ac9e38fa04d42f86b\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5CLwUqB1KZ6tMv8YW2K2fGZsAsDrYU2b42X3sp1hpte6tUfe\",\n        \"hex\": \"0x0c61c9885f4423238e21a7210fc2208ef24d146b2587b194dd66354dbd6f1f73\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 604,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"1063432200988\",\n      \"balance_as_tao\": \"1063432200988\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Datura\",\n      \"hotkey\": {\n        \"ss58\": \"5GP7c3fFazW9GXK8Up3qgu2DJBk8inu4aK9TZy3RuoSWVCMi\",\n        \"hex\": \"0xbefb4b2b719c0dc08273b9293fa8166180fe3c0e6e0fc9f4cb224f429dc8163c\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5G7FbwoHdmqiCPvY8uFS4fp3KGDSdvTcT9Uwk9fwLPcEw4kJ\",\n        \"hex\": \"0xb2e24aaca781c3c4c9ff8e5c665a2666de75ab3ec8e571ec411dbcb313bbb026\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 668,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"991408495157\",\n      \"balance_as_tao\": \"991408495157\"\n    },\n    {\n      \"block_number\": 5373764,\n      \"timestamp\": \"2025-04-17T21:06:24.001Z\",\n      \"hotkey_name\": \"Taostats & Corcel\",\n      \"hotkey\": {\n        \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n        \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5GGhTZXMFMKbJbymyjv8X3XnXocbQhWBxFKXnAqJHbmLHFVZ\",\n        \"hex\": \"0xba16899ba0a2b032dbafcfdbd8cdaa4044fdd32de704c45af1bcc8982301d326\"\n      },\n      \"netuid\": 0,\n      \"subnet_rank\": 677,\n      \"subnet_total_holders\": 42535,\n      \"balance\": \"971007415062\",\n      \"balance_as_tao\": \"97


/* … truncated, full schema in /api/openapi.json */

400 — Bad request

Section titled “400 — Bad request”

404 — Stake balances not found

Section titled “404 — Stake balances 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.