Documentation / API reference / Subnet
Get Current Subnet Pools
Reference
Last reviewed 2026-09-18
Returns the latest subnet pool prices, reserves, market caps and trading activity. Filter by netuid to inspect one subnet pool.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Subnet | |
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, | |
order | query | string | One of rank_asc, rank_desc, root_prop_asc, root_prop_desc, liquidity_asc, liquidity_desc, netuid_asc, netuid_desc, price_asc, price_desc, fear_and_greed_index_asc, fear_and_greed_index_desc, market_cap_asc, market_cap_desc, market_cap_change_one_day_asc, market_cap_change_one_day_desc, total_tao_asc, total_tao_desc, total_alpha_asc, total_alpha_desc, alpha_in_pool_asc, alpha_in_pool_desc, alpha_staked_asc, alpha_staked_desc, tao_volume_one_day_asc, tao_volume_one_day_desc, price_change_one_hour_asc, price_change_one_hour_desc, price_change_one_day_asc, price_change_one_day_desc, price_change_one_week_asc, price_change_one_week_desc, price_change_one_month_asc, price_change_one_month_desc, enabled_user_liquidity_asc, enabled_user_liquidity_desc. |
Responses
200 — Dtao pools retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].alpha_buy_volume_24_hr | string | Yes | |
data[].alpha_in_pool | string | Yes | |
data[].alpha_sell_volume_24_hr | string | Yes | |
data[].alpha_sqrt_price | string, nullable | ||
data[].alpha_staked | string | Yes | |
data[].alpha_volume_24_hr | string | Yes | |
data[].alpha_volume_24_hr_change_1_day | string, nullable | ||
data[].block_number | integer (int32) | Yes | |
data[].buyers_24_hr | integer (int32) | Yes | |
data[].buys_24_hr | integer (int32) | Yes | |
data[].current_tick | integer (int32), nullable | ||
data[].enabled_user_liquidity | boolean, nullable | ||
data[].fear_and_greed_index | string, nullable | ||
data[].fear_and_greed_sentiment | string, nullable | ||
data[].fee_global_alpha | string, nullable | ||
data[].fee_global_tao | string, nullable | ||
data[].fee_rate | string, nullable | ||
data[].highest_price_24_hr | string, nullable | ||
data[].last_price | string, nullable | ||
data[].liquidity | string | Yes | |
data[].liquidity_raw | string, nullable | ||
data[].lowest_price_24_hr | string, nullable | ||
data[].market_cap | string | Yes | |
data[].market_cap_change_1_day | string, nullable | ||
data[].name | string | Yes | |
data[].netuid | integer (int32) | Yes | |
data[].price | string | Yes | |
data[].price_change_1_day | string, nullable | ||
data[].price_change_1_hour | string, nullable | ||
data[].price_change_1_month | string, nullable | ||
data[].price_change_1_week | string, nullable | ||
data[].protocol_provided_alpha | string, nullable | ||
data[].protocol_provided_tao | string, nullable | ||
data[].rank | integer (int32) | Yes | |
data[].root_prop | string | Yes | |
data[].sellers_24_hr | integer (int32) | Yes | |
data[].sells_24_hr | integer (int32) | Yes | |
data[].seven_day_prices | array | Yes | |
data[].seven_day_prices[].block_number | integer (int32) | Yes | |
data[].seven_day_prices[].price | string | Yes | |
data[].seven_day_prices[].timestamp | string (date-time) | Yes | |
data[].startup_mode | boolean | Yes | |
data[].subnet_emission_enabled | boolean | Yes | |
data[].subnet_protocol_alpha | string, nullable | Protocol-owned alpha (subtensorModule.subnetProtocolAlpha), in rao. Null on blocks indexed before the storage item existed on the runtime. | |
data[].swap_v3_initialized | boolean, nullable | ||
data[].symbol | string | Yes | |
data[].tao_buy_volume_24_hr | string | Yes | |
data[].tao_sell_volume_24_hr | string | Yes | |
data[].tao_volume_24_hr | string | Yes | |
data[].tao_volume_24_hr_change_1_day | string, nullable | ||
data[].timestamp | string (date-time) | Yes | |
data[].total_alpha | string | Yes | |
data[].total_tao | string | Yes | |
data[].user_provided_alpha | string, nullable | ||
data[].user_provided_tao | string, nullable | ||
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": [
{
"alpha_in_pool": "45668306365",
"alpha_staked": "623534166709",
"block_number": 5373800,
"buyers_24_hr": 15,
"buys_24_hr": 143,
"liquidity": "256842722.00000000000117255510",
"market_cap": "1881827884.9638468241624855968",
"market_cap_change_1_day": "-78.082354385106581454",
"name": "𝜏",
"netuid": 87,
"price": "0.00281204562248495374",
"price_change_1_day": "-99.971663189188189551",
"price_change_1_hour": "1.163479280047945879",
"price_change_1_week": "-99.983312426933660837",
"rank": 93,
"sellers_24_hr": 10,
"sells_24_hr": 57,
"seven_day_prices": [
{
"block_number": 5323400,
"price": "16.85113593993596993756",
"timestamp": "2025-04-10T21:13:36Z"
},
{
"block_number": 5324600,
"price": "13.660496710324261246",
"timestamp": "2025-04-11T01:13:36Z"
}
],
"startup_mode": false,
"symbol": "ᚳ",
"tao_buy_volume_24_hr": "3195271674",
"tao_sell_volume_24_hr": "4081493598",
"tao_volume_24_hr": "7276765272",
"tao_volume_24_hr_change_1_day": "-78.159708452153354158",
"timestamp": "2025-04-17T21:13:36Z",
"total_alpha": "669202473074",
"total_tao": "128421361"
},
{
"alpha_in_pool": "457446433",
"alpha_staked": "542553567",
"block_number": 5373800,
"buyers_24_hr": 3,
"buys_24_hr": 3,
"liquidity": "4412858721.9999999999982445411",
"market_cap": "4823361167.18610417058",
"market_cap_change_1_day": "12.045508780491647198",
"name": "𝜏",
"netuid": 83,
"price": "4.82336116718610417058",
"price_change_1_day": "12.045508780491647198",
"price_change_1_hour": "0",
"price_change_1_week": "-27.367523781980677256",
"rank": 92,
"sellers_24_hr": 1,
"sells_24_hr": 1,
"seven_day_prices": [
{
"block_number": 5323400,
"price": "6.64077753966135748103",
"timestamp": "2025-04-10T21:13:36Z"
},
{
"block_number": 5324600,
"price": "6.64077753966135748103",
"timestamp": "2025-04-11T01:13:36Z"
}
],
"startup_mode": true,
"symbol": "ᚢ",
"tao_buy_volume_24_hr": "524112243",
"tao_sell_volume_24_hr": "402200428",
"tao_volume_24_hr": "926312671",
"tao_volume_24_hr_change_1_day": null,
"timestamp": "2025-04-17T21:13:36Z",
"total_alpha": "1000000000",
"total_tao": "2206429361"
}
],
"pagination": {
"current_page": 1,
"next_page": null,
"per_page": 1024,
"prev_page": null,
"total_items": 94,
"total_pages": 1
}
}Response details
text
{
"netuid": 19,
"block_number": 5453877,
"timestamp": "2025-04-29T00:09:00Z",
"name": "𝜏",
"symbol": "t",
"rank": 8,
"market_cap": "59441463321024.643624407561697", in tao as rao
"market_cap_change_1_day": "-3.846094939556050115", percentage change
"liquidity": "45018004643438.000000101740943", in rao
"total_tao": "22509002321719", tao in pool as rao
"total_alpha": "856421874395587", total alpha as rao
"alpha_in_pool": "324305642595491", alpha in pool as rao
"alpha_staked": "532116231800096", alpha out as rao
"price": "0.06940675512635053689", price in tao
"price_change_1_hour": "-0.216805016991778647", % change
"price_change_1_day": "-5.034051585669554908", % change
"price_change_1_week": "-29.213601152223015603",% change
"price_change_1_month": "9.183499318978998146",% change
"tao_volume_24_hr": "5625165881462", as rao
"tao_volume_24_hr_change_1_day": "42.469244614287561127",% change
"tao_buy_volume_24_hr": "2564533168881", as rao
"tao_sell_volume_24_hr": "3060632712581", as rao
"buys_24_hr": 1523,
"sells_24_hr": 2052,
"buyers_24_hr": 242,
"sellers_24_hr": 168,
"seven_day_prices": [
{
"block_number": 5403477,
"timestamp": "2025-04-22T00:09:00Z",
"price": "0.0980509762554903941"
},
<snip>
],
"startup_mode": false
}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Dtao pools not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.