Documentation / API reference / dTAO
Get Liquidity Position
Reference
Last reviewed 2026-09-18
Returns subnet liquidity positions with their price ranges, token balances and fee totals. Filter by position ID, coldkey, subnet or status to inspect open or closed positions.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | query | string | ||
coldkey | query | string | SS58 or hex format | |
netuid | query | integer (int32) | ||
status | query | string | One of open, closed, all. | |
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of opened_asc, opened_desc, closed_asc, closed_desc, tao_asc, tao_desc, alpha_asc, alpha_desc, liquidity_asc, liquidity_desc, netuid_asc, netuid_desc, fees_claimable_tao_asc, fees_claimable_tao_desc, fees_claimable_alpha_asc, fees_claimable_alpha_desc, fees_claimed_tao_asc, fees_claimed_tao_desc, fees_claimed_alpha_asc, fees_claimed_alpha_desc, tao_committed_asc, tao_committed_desc, alpha_committed_asc, alpha_committed_desc. |
Responses
200 — Liquidity positions retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].alpha | string | Yes | |
data[].alpha_committed | string | Yes | |
data[].alpha_withdrawn | string | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].closed_block_number | integer (int32), nullable | ||
data[].closed_timestamp | string (date-time), nullable | ||
data[].coldkey | object | Yes | |
data[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].fees_claimable_alpha | string | Yes | |
data[].fees_claimable_tao | string | Yes | |
data[].fees_claimed_alpha | string | Yes | |
data[].fees_claimed_tao | string | Yes | |
data[].id | string | Yes | |
data[].last_modified_block_number | integer (int32), nullable | ||
data[].last_modified_timestamp | string (date-time), nullable | ||
data[].liquidity | string | Yes | |
data[].max_price | string | Yes | |
data[].min_price | string | Yes | |
data[].netuid | integer (int32) | Yes | |
data[].opened_block_number | integer (int32) | Yes | |
data[].opened_timestamp | string (date-time) | Yes | |
data[].tao | string | Yes | |
data[].tao_committed | string | Yes | |
data[].tao_withdrawn | string | Yes | |
data[].tick_high | integer (int32) | Yes | |
data[].tick_low | integer (int32) | Yes | |
data[].timestamp | string (date-time) | Yes | |
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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Liquidity positions not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.