Skip to content
TAO$189.21
BTC0.002941
MCap$2.22B
Vol$86.30M

API reference / Accounts

Get Wallet Cost Basis

GET/api/v2/accounts/cost-basis
Status
Beta
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

What each account paid for what it holds, what it is worth, and how it got there.

Full description

What each account paid for what it holds, what it is worth, and how it got there: per account, every position at a UTC day's close with its cost basis, value, unrealized and realized gain and income by kind, in TAO and a reporting currency (currency, default USD: the *_fiat members); a summary per account; and the whole request summed as one portfolio (meta.totals).

## Use cases - Wallet performance: cost basis and unrealized gain per position for a portfolio page. - Many wallets as one: a fund or an operator's coldkeys summed in meta.totals. - Per subnet: netuid (and asset) narrows every account to one subnet.

## Business logic Average-cost basis per position, a position being one (account, asset, subnet, subnet life): every acquisition adds its cost (TAO paid, or the value at receipt for income) and every disposal removes the average cost of the units it takes. Assets: alpha (subnet stake), root (root stake), tao_free (free TAO), tao_claims (TAO owed back to the account: refundable locks, crowdloan contributions, contract deposits and the payouts still due from a removed subnet), basket (fund units) and lp (liquidity positions). Income is valued at receipt and split by kind: subnet emission, root dividends, root pool growth, hotkey-swap misallocation (value gained when a hotkey swap, before the chain changed swaps in March 2026, combined two stake pools without repricing their shares), the block author's fee share and subnet-owner emission. Growth of subnet alpha pools is served beside them (income_growth_*, all pool growth) but is value growth, not income. Burns and standalone transaction fees are expenses of their value (burn_cost_*, fee_cost_standalone_*), each also a disposal at the average cost. Unrealized = value - basis (signed); realized is the gain on disposals since the first acquisition. Root dividends accrued but not yet claimed are not in any amount.

## Summaries Each summed figure is {amount, complete, excluded_positions}: amount sums the positions where the figure is known, excluded_positions counts those where it is not, and complete is true when none is left out. Basis and value are never negative, nor are units: their sums are of non-negative figures, so with complete false the amount is a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound. Units are never summed (alpha is per subnet). A repeated address is answered as given in data and counted once in meta.totals.

## Closed positions A position sold or moved out entirely is closed (is_open false): it holds no units, but keeps the realized gain, income and flows of its life. Closed positions are listed only with include_closed=true, and are always summed (summary, meta.totals, meta.groups; open_positions counts the open ones), so totals stay whole whether they are listed or not.

## Groups group_by=netuid (per subnet life) or group_by=asset also sums the set's positions per group in meta.groups (each a group identity and a summary shaped like meta.totals), largest TAO value first. group_limit=N keeps the top N and sums the rest into one other group, for a chart with a stable legend.

## Money-weighted return Money-weighted return (include=mwr): the return on the money actually put in, weighted by when and how much went in and came out. It is the internal rate of return (IRR) of the flows in and out and the value at the end when that has a unique solution, else the Modified Dietz return. Income received (emission, root dividends, root pool growth) counts as return, not as money put in. Stated over the period from the first money in (mwr_from_day) to mwr_to_day: the day asked, or for a closed position the day it closed (a closed position is measured through the day it closed). Annualised only over a period of at least 365 days, never over a shorter one. A position with under $1 invested is left out as dust: below_dust when it is also worth under $1, else no_invested_capital; a group's return leaves its dust out and counts it in mwr_dust_positions. carry_unknown on any member makes a group's return unavailable. At most 5 distinct addresses with include=mwr. Each position, meta.totals, each account's summary and each named group in meta.groups carry it (the other group never); without include=mwr the mwr_* members are null. When the return cannot be computed in time, the answer is still served with every other figure, and every mwr_* reason member is temporarily_unavailable (retry shortly).

## Income income_tao_rao is exactly the sum of its three parts. An income part whose value in the reporting currency is unknown is null (rate_unknown: the rate at receipt is missing), and so is the total in that currency; summaries then leave that position out of the fiat income sums (excluded_positions).

## Known issue A small residual of sales still takes more units than the position held at that point in its day: the extra units leave with no cost, so that sale's realized gain is overstated and the cost basis of the units acquired afterwards is understated by the same amount; over the position's whole life the total is unchanged, only its timing moves. Units that arrived without a matching recorded acquisition are given a cost at the day's closing price instead of being shown as unknown. Root rewards that the chain claimed and swapped to TAO automatically (blocks 6,811,691 to 8,765,683) are counted as income at the TAO received, not at the fair value of the alpha claimed; the swap's slippage is therefore left out of both income and realized gain. Income received in a block where the pool was traded earlier in the same block is valued at the price before those trades, not at the price after the block; this overstates income, almost all of it received between 23 February and 24 March 2025. Holdings are valued at the pool's spot price at the day's close; on a pool too thin to be an active market, that is not its fair value, so value and unrealized gain there are overstated. A sale's realized gain counts its swap fee as part of the proceeds, so it is overstated by that fee. Corrections are in progress; the affected figures change when they are served.

## Unknown figures A figure that cannot be known is null with a reason in the row's unavailable_reasons, never 0: unvalued (some units entered with no known cost: unvalued_units; the basis is unknown), price_unknown (the asset's close price is unknown, so its value is unknown in TAO and in the reporting currency), rate_unknown (the TAO figure is known but the rate to the reporting currency is not: only the figure in that currency is null), flows_unvalued (a day's price effect, while its flows are not all valued; in the reporting currency the price effect is not computed yet, so it is null there). Unrealized and totals use known figures only. meta.available_assets lists the assets covered so far: another asset has no figures yet.

## Data freshness Computed from the analytics store after each UTC day closes: the newest day is meta.through_day, and meta.sources names the store and its last block. A day more than 6 hours overdue (at most 36) is still served, labelled by meta.through_day, with the response headers X-BTAI-Data-Through: <YYYY-MM-DD> and X-BTAI-Overdue-S: <seconds> (cached as slow). A store more than 36 hours overdue, or still computing, is a 503 SOURCE_NOT_READY with Retry-After. While the figures are recalculated under a corrected method, a range that spans recalculated and not yet recalculated days is a 503 RECALCULATING with Retry-After: an answer never mixes the two. Where this deployment does not serve cost basis yet, every route is a 503 SOURCE_NOT_READY.

Cached as settled when pinned to a closed day before meta.through_day, else for 5 minutes.

## Errors application/problem+json: ADDRESSES_REQUIRED, BATCH_TOO_LARGE, INVALID_ADDRESS, INVALID_ASSET, INVALID_NETUID, INVALID_CURRENCY, INVALID_GROUP_BY, INVALID_GROUP_LIMIT, INVALID_DAY, INVALID_BOOLEAN (include_closed), INVALID_INCLUDE, UNKNOWN_PARAMETER, NOT_READY (503, reason day_not_closed: the day asked is after the newest available day), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503), RECALCULATING (503, Retry-After: a recalculation is part-way through the range), SERVICE_UNAVAILABLE (503), BAD_GATEWAY (502).

Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).

Query parameters

addressquery· string

A comma list of 1..60 accounts (coldkeys), SS58 or 0x + 64 hex. The edge caps the request line at 4,094 bytes, so a longer list is a 400 BATCH_TOO_LARGE: use the POST /batch form (up to 500). Omitted or empty: 400 ADDRESSES_REQUIRED; an invalid entry: 400 INVALID_ADDRESS naming its index.

assetquery· enum · one of alpha, root, tao_free, tao_claims, basket, lp

Only positions in this asset: alpha (subnet stake), root (root stake), tao_free (free TAO), tao_claims (TAO owed back to the account, the dissolution receivable included), basket (fund units) or lp (liquidity positions). Default: every asset. Anything else is a 400 INVALID_ASSET.

netuidquery· integer

Only positions on this subnet (0 = root), 0..65535. Default: every subnet. Anything else is a 400 INVALID_NETUID.

currencyquery· string

The reporting currency of the *_fiat amounts: an ISO 4217 code in upper case (default USD), one of meta.available_currencies. Each amount in it uses the TAO price in that currency at the time of its own leg (a basis at acquisition, a value at the day's close), never today's rate applied to a USD figure. Anything else is a 400 INVALID_CURRENCY.

dayquery· string

The UTC day, YYYY-MM-DD, at its close (default: the newest available day, meta.through_day). Not a date, or before meta.coverage_from_day: a 400 INVALID_DAY; after meta.through_day: a 503 NOT_READY.

group_byquery· enum · one of netuid, asset

Also sum the request's positions per group in meta.groups: netuid (one group per subnet life: netuid, generation and life_start_height) or asset. Default: not grouped (meta.groups null). Anything else is a 400 INVALID_GROUP_BY.

group_limitquery· integer

With group_by: keep the top N groups (1..1000) by TAO value on the last day served, plus one other group summing the rest; 0 (the default) keeps every group. Out of range, or above 0 without group_by: a 400 INVALID_GROUP_LIMIT.

include_closedquery· boolean · default false

Also list the closed positions (is_open false: no units at the day's close, but a realized gain, income or flows since the first acquisition). Default false: only open positions are listed. Either way every position, closed ones included, is in the summaries, meta.totals and meta.groups, so the realized gain and income there are whole. Not true or false: a 400 INVALID_BOOLEAN.

includequery· string

A comma list of optional sections: mwr adds the money-weighted return to every position, to each account's summary, to meta.totals and to meta.groups (the mwr_* members, null without it). With include=mwr the request takes at most 5 distinct addresses (more: a 400 BATCH_TOO_LARGE). Anything else is a 400 INVALID_INCLUDE.

Response

data is a list of objects with these fields. Amounts are integer strings in their base unit, and null means unknown, never zero (see Units and formats). meta.at names the block the answer was read at.

One item per requested address, in request order (a duplicate is answered as given).

addressobject

The account (coldkey), in both encodings.

2 fields in address
ss58string

The account, SS58 (prefix 42).

Format: SS58 address
hexstring

The same 32-byte account id, 0x + 64 lower-case hex (the public key).

Format: 32-byte hex: 0x and 64 hex digits
summaryobject

This account's positions summed.

61 fields in summary
positionsinteger · unit count

Positions summed, open and closed (each figure may leave some out). A closed position adds 0 to basis, value and unrealized (known: never left out) but keeps its realized gain, income and flows.

open_positionsinteger · unit count

Of positions, those holding units at the day's close (is_open).

basis_tao_raoobject

Cost basis, TAO (rao). A sum of non-negative figures: >= 0, and a lower bound on the total when complete is false.

3 fields in basis_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

basis_fiatobject

Cost basis, in the reporting currency. A sum of non-negative figures: >= 0, and a lower bound on the total when complete is false.

3 fields in basis_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

value_tao_raoobject

Value at the day's close, TAO (rao). A sum of non-negative figures: >= 0, and a lower bound on the total when complete is false.

3 fields in value_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

value_fiatobject

Value at the day's close, in the reporting currency. A sum of non-negative figures: >= 0, and a lower bound on the total when complete is false.

3 fields in value_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

unrealized_tao_raoobject

Unrealized gain (value - basis), TAO (rao). Signed: with complete false, not a bound on the total.

3 fields in unrealized_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

unrealized_fiatobject

Unrealized gain (value - basis), in the reporting currency. Signed: with complete false, not a bound on the total.

3 fields in unrealized_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

realized_cum_tao_raoobject

Realized gain on disposals since the first acquisition, TAO (rao). Only disposals of units whose cost is known: a leg taking units whose cost is unknown is left out and counted in realized_cum_unknown_legs (unknown is never 0). Null (not_ready) where it is not computed yet. Signed: with complete false, not a bound on the total.

3 fields in realized_cum_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

realized_cum_unknown_legsinteger · unit count · can be null

How many disposal legs since the first acquisition are left out of realized_cum_tao_rao.amount because the cost of the units they took is unknown: their gain is not in it. 0 when every cost is known. Null (not_ready) where it is not computed yet. The positions' counts summed; null when any position's is.

realized_cum_fiatobject

Realized gain on disposals since the first acquisition, in the reporting currency. Only disposals whose gain in the reporting currency is known: a leg taking units whose cost is unknown, or with no TAO to reporting-currency rate, is left out and counted in realized_cum_fiat_unknown_legs (unknown is never 0). Null (not_ready) where it is not computed yet. Signed: with complete false, not a bound on the total.

3 fields in realized_cum_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

realized_cum_fiat_unknown_legsinteger · unit count · can be null

How many disposal legs since the first acquisition are left out of realized_cum_fiat.amount because their gain in the reporting currency is unknown (the cost of the units they took is unknown, or the TAO to reporting-currency rate is missing): their gain is not in it. Counted apart from the TAO legs: a missing rate leaves a leg out in the reporting currency only. 0 when every gain is known. Null (not_ready) where it is not computed yet. The positions' counts summed; null when any position's is.

income_emission_tao_raoobject

Subnet emission income since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_emission_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_root_tao_raoobject

Root dividend income received since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_root_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_growth_tao_raoobject

Pool growth of every pool held (subnet alpha pools and root). Only its root part (income_root_growth_*) counts as income: growth of a subnet's alpha pool is value growth, already in the value and the unrealized gain, so it is not in the income totals. Since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_growth_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_root_growth_tao_raoobject

Root pool growth: the growth of the root stake pool, the part of pool growth (income_growth_*) that counts as income. 0 on every position outside root. Null (not_ready) where it is not computed yet. Since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_root_growth_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_swap_misallocation_tao_raoobject

Hotkey-swap misallocation: value gained when a hotkey swap, before the chain changed swaps in March 2026 to move stake by value, combined two stake pools without repricing their shares, so value moved from one pool's stakers to the other's; counted as income at its value when received, less any part the chain later took back. 0 for nearly every account. Since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_swap_misallocation_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_fee_tao_raoobject

Block-author fee share: the share of transaction fees paid to the block author, received to free TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, TAO (rao). A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in income_fee_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_owner_tao_raoobject

Subnet-owner emission: emission paid to a subnet owner's free TAO before dynamic TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, TAO (rao). A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in income_owner_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_opening_tao_raoobject

Pre-dTAO opening income: the lifetime income received through the 2025-02-12 UTC close (block 4,913,846, the last close before the dTAO launch at block 4,920,351), carried as one constant from the pre-dTAO boundary carry (income after that close is in the other parts), valued at receipt 1 TAO for 1 TAO. Present only on the TAO holder's root position (asset root, netuid 0, generation 0; 0 elsewhere), and also on a closed one when the holder's TAO left before the carry. Not a staking reward, and never in a day's figures (the series). TAO (rao).

3 fields in income_opening_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_tao_raoobject

All income since the first acquisition, TAO (rao): exactly subnet emission + root dividends + root pool growth + hotkey-swap misallocation + block-author fee share + subnet-owner emission (income_emission_* + income_root_* + income_root_growth_* + income_swap_misallocation_* + income_fee_* + income_owner_*). Growth of subnet alpha pools is not income, so the total is not the sum of all the parts when an alpha pool grew. While income_fee_* and income_owner_* are null (not_ready: not computed yet), the total leaves them out. On the TAO holder's root position the total also includes the pre-dTAO opening income (income_opening_*).

3 fields in income_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_emission_fiatobject

Subnet emission income since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_emission_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_root_fiatobject

Root dividend income since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_root_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_growth_fiatobject

Pool growth of every pool held (subnet alpha pools and root). Only its root part (income_root_growth_*) counts as income: growth of a subnet's alpha pool is value growth, already in the value and the unrealized gain, so it is not in the income totals. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_growth_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_root_growth_fiatobject

Root pool growth: the growth of the root stake pool, the part of pool growth (income_growth_*) that counts as income. 0 on every position outside root. Null (not_ready) where it is not computed yet. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_root_growth_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_swap_misallocation_fiatobject

Hotkey-swap misallocation: value gained when a hotkey swap, before the chain changed swaps in March 2026 to move stake by value, combined two stake pools without repricing their shares, so value moved from one pool's stakers to the other's; counted as income at its value when received, less any part the chain later took back. 0 for nearly every account. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_swap_misallocation_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_fee_fiatobject

Block-author fee share: the share of transaction fees paid to the block author, received to free TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, in the reporting currency. A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in income_fee_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_owner_fiatobject

Subnet-owner emission: emission paid to a subnet owner's free TAO before dynamic TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, in the reporting currency. A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in income_owner_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_opening_fiatobject

Pre-dTAO opening income: the lifetime income received through the 2025-02-12 UTC close (block 4,913,846, the last close before the dTAO launch at block 4,920,351), carried as one constant from the pre-dTAO boundary carry (income after that close is in the other parts), valued at receipt 1 TAO for 1 TAO. Present only on the TAO holder's root position (asset root, netuid 0, generation 0; 0 elsewhere), and also on a closed one when the holder's TAO left before the carry. Not a staking reward, and never in a day's figures (the series). In the reporting currency, valued at receipt. A position whose opening has no TAO-to-currency rate is in excluded_positions.

3 fields in income_opening_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_fiatobject

All income since the first acquisition, in the reporting currency: exactly subnet emission + root dividends + root pool growth + hotkey-swap misallocation + block-author fee share + subnet-owner emission (income_emission_* + income_root_* + income_root_growth_* + income_swap_misallocation_* + income_fee_* + income_owner_*). Growth of subnet alpha pools is not income, so the total is not the sum of all the parts when an alpha pool grew. While income_fee_* and income_owner_* are null (not_ready: not computed yet), the total leaves them out. On the TAO holder's root position the total also includes the pre-dTAO opening income (income_opening_*). A position counts only when all of its income parts (emission, root dividends, root pool growth, hotkey-swap misallocation, block-author fee share, subnet-owner emission, pre-dTAO opening) are known (else it is in excluded_positions).

3 fields in income_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

staking_rewards_tao_raoobject

Staking rewards: what staking paid, exactly subnet emission + root dividends + pool growth (income_emission_* + income_root_* + income_growth_*), pool growth being the rise in a validator pool's value per unit as rewards accrue to it (an accumulating fund). Price moves and hotkey-swap misallocation are not in it. Unlike the income totals (income_*, which follow the method in meta.lens), it counts all pool growth, subnet alpha pools' included. Since the first acquisition, valued at receipt, TAO (rao). Never includes the block-author fee share or subnet-owner emission (income_fee_*, income_owner_*).

3 fields in staking_rewards_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

staking_rewards_fiatobject

Staking rewards: what staking paid, exactly subnet emission + root dividends + pool growth (income_emission_* + income_root_* + income_growth_*), pool growth being the rise in a validator pool's value per unit as rewards accrue to it (an accumulating fund). Price moves and hotkey-swap misallocation are not in it. Unlike the income totals (income_*, which follow the method in meta.lens), it counts all pool growth, subnet alpha pools' included. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). A position counts only when all three of its parts are known (else it is in excluded_positions). Never includes the block-author fee share or subnet-owner emission (income_fee_*, income_owner_*).

3 fields in staking_rewards_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_alpha_growth_tao_raoobject

Alpha pool growth: the subnet alpha pools' part of pool growth, exactly income_growth_* - income_root_growth_*. Counted as appreciation, not income, under the fund method (meta.lens), so it is not in the income totals; it is in staking_rewards_*. 0 on root positions. Null (not_ready) where root pool growth is not computed yet. Since the first acquisition, valued at receipt, TAO (rao).

3 fields in income_alpha_growth_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

income_alpha_growth_fiatobject

Alpha pool growth: the subnet alpha pools' part of pool growth, exactly income_growth_* - income_root_growth_*. Counted as appreciation, not income, under the fund method (meta.lens), so it is not in the income totals; it is in staking_rewards_*. 0 on root positions. Null (not_ready) where root pool growth is not computed yet. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate).

3 fields in income_alpha_growth_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

external_in_tao_raoobject

Value brought in from outside the account (transfers and stakes in), TAO (rao).

3 fields in external_in_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

external_out_tao_raoobject

Value taken out of the account (transfers and unstakes out), TAO (rao).

3 fields in external_out_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

burn_cost_tao_raoobject

Burn cost: units burned, an expense of their value. On the TAO position (asset root): TAO burned (a burn, a registration or lock burn, a claim or escrow burn), 1 TAO for 1 TAO, in the reporting currency at the burn's minute. On an alpha position: the alpha burned or recycled, at its value at the burn's block. Each burn is also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). Spent since the first acquisition, TAO (rao). A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in burn_cost_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

burn_cost_fiatobject

Burn cost: units burned, an expense of their value. On the TAO position (asset root): TAO burned (a burn, a registration or lock burn, a claim or escrow burn), 1 TAO for 1 TAO, in the reporting currency at the burn's minute. On an alpha position: the alpha burned or recycled, at its value at the burn's block. Each burn is also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). Spent since the first acquisition, in the reporting currency. A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in burn_cost_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

fee_cost_standalone_tao_raoobject

Standalone fee cost: on the TAO position (asset root), the transaction fees paid in TAO (the transaction fee and EVM gas) netted per UTC day and booked when the day closes, at the day's mean TAO price in the reporting currency, plus EVM fee events at their minute; on an alpha position, the transaction fees paid in its alpha, at their value. An expense of its value, each also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). A swap's fee inside its proceeds is not a standalone fee and is not here. Spent since the first acquisition, TAO (rao). A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in fee_cost_standalone_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

fee_cost_standalone_fiatobject

Standalone fee cost: on the TAO position (asset root), the transaction fees paid in TAO (the transaction fee and EVM gas) netted per UTC day and booked when the day closes, at the day's mean TAO price in the reporting currency, plus EVM fee events at their minute; on an alpha position, the transaction fees paid in its alpha, at their value. An expense of its value, each also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). A swap's fee inside its proceeds is not a standalone fee and is not here. Spent since the first acquisition, in the reporting currency. A position where it is not computed yet (not_ready) is in excluded_positions.

3 fields in fee_cost_standalone_fiat
amountstring · unit ccy

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). In the reporting currency (meta.currency).

can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

claims_receivable_tao_raoobject

The open dissolution receivable: TAO that a removed subnet's pool still owes the account, between the subnet's removal (when the position in it was disposed of) and the payouts, held at its TAO amount (1 TAO = 1 TAO). It is part of the tao_claims position's units, not in addition to them: the account's TAO is root + tao_free + tao_claims, and this is the part of tao_claims still to be paid. When a payout lands, its amount moves to tao_free. 0 on every other position, and when nothing is owed. Always present, never absent: 0 while this figure is not yet computed: the ended position's alpha then stays held until the payouts arrive as tao_free. Summed over the positions; already inside value_tao_rao (the tao_claims positions' value), never to be added to it.

3 fields in claims_receivable_tao_rao
amountstring · unit rao (÷1e9)

The sum over the positions where this figure is known. 0 when no position has it. With complete false it leaves out excluded_positions positions whose figure is unknown. Basis and value (and income and flows in TAO) sum figures that are each >= 0, so the amount is never negative and, with complete false, a lower bound on the total. Unrealized and realized are signed: with complete false the amount is not a bound (the positions left out can move it either way). Integer rao of TAO (divide by 1e9).

Format: whole number, as a string · can be negative
completeboolean

True when every position's figure is known (excluded_positions is 0).

excluded_positionsinteger · unit count

How many positions are left out of amount because their figure is unknown.

unrealized_return_ratiostring · unit ratio · can be null

Unrealized return of the positions summed: unrealized_tao_rao.amount / basis_tao_rao.amount, signed, 8 decimals, stated only when both sums are complete. Null exactly with unrealized_return_unavailable_reason.

Format: decimal number, as a string · can be negative
unrealized_return_unavailable_reasonstring · can be null

Why unrealized_return_ratio is null; null when it is stated. no_basis: the basis is 0 (a closed position, or units held at no cost); basis_unknown: the basis or the unrealized gain is null; incomplete (summaries only): the summed basis or unrealized gain leaves positions out (complete false), so no ratio of partial sums is stated. New values may be added; treat unknown values as unavailable.

unrealized_return_fiat_ratiostring · unit ratio · can be null

Unrealized return in the reporting currency: unrealized_fiat.amount / basis_fiat.amount, signed, 8 decimals, stated only when both sums are complete. Null exactly with unrealized_return_fiat_unavailable_reason.

Format: decimal number, as a string · can be negative
unrealized_return_fiat_unavailable_reasonstring · can be null

Why unrealized_return_fiat_ratio is null; null when it is stated. no_basis: the basis is 0 (a closed position, or units held at no cost); basis_unknown: the basis or the unrealized gain is null; incomplete (summaries only): the summed basis or unrealized gain leaves positions out (complete false), so no ratio of partial sums is stated. New values may be added; treat unknown values as unavailable.

mwr_ratiostring · unit ratio · can be null

Money-weighted return of the positions summed in TAO over mwr_from_day..mwr_to_day (the whole period, not annualised), signed, 8 decimals (0.25 = up 25%). Null exactly with mwr_unavailable_reason, and without include=mwr. Money-weighted return (include=mwr): the return on the money actually put in, weighted by when and how much went in and came out. It is the internal rate of return (IRR) of the flows in and out and the value at the end when that has a unique solution, else the Modified Dietz return. Income received (emission, root dividends, root pool growth) counts as return, not as money put in. Stated over the period from the first money in (mwr_from_day) to mwr_to_day: the day asked, or for a closed position the day it closed (a closed position is measured through the day it closed). Annualised only over a period of at least 365 days, never over a shorter one. A position with under $1 invested is left out as dust: below_dust when it is also worth under $1, else no_invested_capital; a group's return leaves its dust out and counts it in mwr_dust_positions. carry_unknown on any member makes a group's return unavailable. On the other group, null (its return is not computed).

Format: decimal number, as a string · can be negative
mwr_annualized_ratiostring · unit ratio · can be null

mwr_ratio as a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly with mwr_annualized_unavailable_reason. Null without include=mwr. On the other group, null (its return is not computed).

Format: decimal number, as a string · can be negative
mwr_methodstring · can be null

How mwr_ratio is computed: irr (the internal rate of return, which has a unique solution here) or modified_dietz (the Modified Dietz return, where the IRR has none). Null when mwr_ratio is. New values may be added; show an unknown value as is (or generically).

mwr_unavailable_reasonstring · can be null

Why mwr_ratio is null; null when it is stated (and without include=mwr). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_annualized_unavailable_reasonstring · can be null

Why mwr_annualized_ratio is null; null when it is stated (and without include=mwr). The period return's reasons, and two of annualising: window_below_365_days (held under a year, so there is no yearly figure) and not_annualizable (the period lost 100% or more, so it has no yearly equivalent). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_fiat_ratiostring · unit ratio · can be null

Money-weighted return of the positions summed in the reporting currency over mwr_from_day..mwr_to_day (the whole period, not annualised), signed, 8 decimals (0.25 = up 25%). Null exactly with mwr_fiat_unavailable_reason, and without include=mwr. Money-weighted return (include=mwr): the return on the money actually put in, weighted by when and how much went in and came out. It is the internal rate of return (IRR) of the flows in and out and the value at the end when that has a unique solution, else the Modified Dietz return. Income received (emission, root dividends, root pool growth) counts as return, not as money put in. Stated over the period from the first money in (mwr_from_day) to mwr_to_day: the day asked, or for a closed position the day it closed (a closed position is measured through the day it closed). Annualised only over a period of at least 365 days, never over a shorter one. A position with under $1 invested is left out as dust: below_dust when it is also worth under $1, else no_invested_capital; a group's return leaves its dust out and counts it in mwr_dust_positions. carry_unknown on any member makes a group's return unavailable. On the other group, null (its return is not computed).

Format: decimal number, as a string · can be negative
mwr_fiat_annualized_ratiostring · unit ratio · can be null

mwr_fiat_ratio as a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly with mwr_fiat_annualized_unavailable_reason. Null without include=mwr. On the other group, null (its return is not computed).

Format: decimal number, as a string · can be negative
mwr_fiat_methodstring · can be null

How mwr_fiat_ratio is computed: irr (the internal rate of return, which has a unique solution here) or modified_dietz (the Modified Dietz return, where the IRR has none). Null when mwr_fiat_ratio is. New values may be added; show an unknown value as is (or generically).

mwr_fiat_unavailable_reasonstring · can be null

Why mwr_fiat_ratio is null; null when it is stated (and without include=mwr). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_fiat_annualized_unavailable_reasonstring · can be null

Why mwr_fiat_annualized_ratio is null; null when it is stated (and without include=mwr). The period return's reasons, and two of annualising: window_below_365_days (held under a year, so there is no yearly figure) and not_annualizable (the period lost 100% or more, so it has no yearly equivalent). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_from_daystring (date) · can be null

The first day of the money-weighted return's period: the day of the first money in. Null without include=mwr.

Format: date, YYYY-MM-DD
mwr_to_daystring (date) · can be null

The last day of the money-weighted return's period: the last day of any position summed (meta.day, or the day the last of them closed). Null without include=mwr.

Format: date, YYYY-MM-DD
mwr_dust_positionsinteger · unit count · can be null

Of positions, those left out of the money-weighted return as dust (under $1 invested). Null without include=mwr. On the other group, null (its return is not computed).

internal_transfer_basis_approxboolean

True when any position summed carries a basis moved in from another account at an approximate cost (internal_transfer_basis_approx on that position). On meta.totals and meta.groups also true whenever the request sums several accounts (as the series' flag): each account's own basis is summed, so a move between them is not matched to its original cost. A single account's summary is never approximate for that reason, so an account false and the set true is consistent.

basis_estimatedboolean

True when any position summed has an estimated basis (basis_estimated on that position: units received from another account at their fair value at receipt).

excluded_reasonsobject

Why summed figures leave positions out: per figure with excluded_positions above 0, the positions left out by reason (each position's unavailable_reasons; the counts add up to that figure's excluded_positions). Empty when every figure is complete. unvalued: some units entered with no known cost (no price paid on record, and no value at receipt or close price to stand in for one), so the basis and anything computed from it is unknown. price_unknown: the asset's close price that day is unknown, so its value is unknown in TAO and in the reporting currency. rate_unknown: the TAO figure is known, but the rate from TAO to the reporting currency it needs (at the close, or at the time of an acquisition, a disposal or a receipt) is not, so only the figure in the reporting currency is unknown. flows_unvalued: a flow is not valued: on a series row, the day's flows are not all valued (in the reporting currency: not yet), so the price effect and its split cannot be separated from them; on burn_cost_* and fee_cost_standalone_*, a burn or fee whose value is unknown. mixed_units (series): the row sums several assets or subnet lives, whose units are not comparable, so it has no unit count. not_ready: the figure is not computed yet. New values may be added; show an unknown value as is (or generically). New values may be added; treat unknown values as unavailable.

positionsarray of objects

Its open positions (with include_closed, also the closed ones that still carry realized, income or flow figures), by asset, netuid and life; [] when none match. summary sums them all, listed or not.

74 fields in positions (each item)
assetstring

alpha: stake on a subnet. root: stake on root (netuid 0). tao_free: free TAO. tao_claims: TAO owed back to the account (refundable locks, crowdloan contributions, contract deposits and payouts still due from a removed subnet; claims_receivable_tao_rao is the last part). basket: units of a fund. lp: a liquidity position. New values may be added; show an unknown value as is (or generically).

netuidinteger · unit id · can be null

The subnet (0 = root); null for tao_free and tao_claims.

generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. The subnet life the position was held in (a netuid is reused when a subnet is replaced). Null where there is no life (tao_free, tao_claims).

life_start_heightinteger · unit block · can be null

The first block of the life generation names (GET /subnets/generations' start_height): use it, never generation, for heights, ages and dates. Null exactly when generation is null (root without a life, no subnet), or transiently when this API cannot read the lives. Root's generation 0 starts at 0.

is_current_lifeboolean · can be null

Whether generation is the slot's current life (true) or an ended one, re-registered since (false). Null exactly when generation is null, or transiently when this API cannot read the lives. Root's generation 0 is current.

fund_hotkeyobject · can be null

The fund (its hotkey) on a basket row: one row per fund; null on every other asset. A basket row's money-weighted return (include=mwr) is all the account's funds together.

2 fields in fund_hotkey
ss58string

The account, SS58 (prefix 42).

Format: SS58 address
hexstring

The same 32-byte account id, 0x + 64 lower-case hex (the public key).

Format: 32-byte hex: 0x and 64 hex digits
quantity_unitstring · can be null

The base unit of units and the other unit counts: alpha_rao (1e-9 alpha of the subnet; on root, TAO), tao_rao (rao of TAO), fund_units (a fund's units, a whole count), liquidity (raw liquidity units). Units of different positions are never summed. Null for an asset this API does not know yet. New values may be added; show an unknown value as is (or generically).

is_openboolean

True when the position holds units at the day's close (units not 0). A closed position (false) is served only with include_closed: its basis, value and unrealized are 0 in TAO and the reporting currency (known whatever the close price), its realized gain, income and flows since the first acquisition stay.

unitsstring · unit lot_quantity (per quantity_unit)

Units held at the day's close, in quantity_unit: above 0 when open, 0 when closed. Never negative (>= 0).

Format: whole number, as a string
unknown_basis_unitsstring · unit lot_quantity (per quantity_unit)

Units that left the position without a proven counterpart (a move between holders with no matching arrival), since the first acquisition: taken out at the average cost, with no gain or loss recorded. Informational: no figure is unknown because of it.

Format: whole number, as a string
unvalued_unitsstring · unit lot_quantity (per quantity_unit)

Units that entered the position with no known cost (no price paid on record, and no value at receipt or close price), since the first acquisition. Above 0 on a position held that day, the basis is unknown (unvalued).

Format: whole number, as a string
residual_in_unitsstring · unit lot_quantity (per quantity_unit)

Units that arrived without a matching recorded acquisition (counted, at no known cost).

Format: whole number, as a string
residual_out_unitsstring · unit lot_quantity (per quantity_unit)

Units that left without a matching held lot (a disposal larger than the units on record).

Format: whole number, as a string
burn_unitsstring · unit lot_quantity (per quantity_unit) · can be null

Units burned or recycled since the first acquisition, in quantity_unit (burn_cost_* is their value). Never negative (>= 0). Null (not_ready) where it is not computed yet.

Format: whole number, as a string
close_price_taostring · unit tao_per_alpha · can be null

The day's close price in TAO per whole unit of the asset (TAO per alpha; 1 on root and for free TAO; per fund unit for basket). Null when unknown: unavailable_reasons names why (never 0 for unknown).

basis_tao_raostring · unit rao (÷1e9) · can be null

Cost basis of the units held, TAO (rao); 0 when closed. Never negative (>= 0). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
basis_fiatstring · unit ccy · can be null

Cost basis of the units held, in the reporting currency; 0 when closed. Never negative (>= 0). Null when unknown: unavailable_reasons names why (never 0 for unknown).

value_tao_raostring · unit rao (÷1e9) · can be null

Value at the day's close, TAO (rao); 0 when closed. Never negative (>= 0). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
value_fiatstring · unit ccy · can be null

Value at the day's close, in the reporting currency; 0 when closed. Never negative (>= 0). Null when unknown: unavailable_reasons names why (never 0 for unknown).

unrealized_tao_raostring · unit rao (÷1e9) · can be null

Unrealized gain: value_tao_rao - basis_tao_rao (signed), TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · can be negative
unrealized_fiatstring · unit ccy · can be null

Unrealized gain: value_fiat - basis_fiat (signed), in the reporting currency. Null when unknown: unavailable_reasons names why (never 0 for unknown).

can be negative
realized_cum_tao_raostring · unit rao (÷1e9) · can be null

Realized gain on disposals since the first acquisition (signed), TAO (rao). Only disposals of units whose cost is known: a leg taking units whose cost is unknown is left out and counted in realized_cum_unknown_legs (unknown is never 0). Null (not_ready) where it is not computed yet. Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · can be negative
realized_cum_unknown_legsinteger · unit count · can be null

How many disposal legs since the first acquisition are left out of realized_cum_tao_rao because the cost of the units they took is unknown: their gain is not in it. 0 when every cost is known. Null (not_ready) where it is not computed yet.

realized_cum_fiatstring · unit ccy · can be null

Realized gain on disposals since the first acquisition (signed), in the reporting currency. Only disposals whose gain in the reporting currency is known: a leg taking units whose cost is unknown, or with no TAO to reporting-currency rate, is left out and counted in realized_cum_fiat_unknown_legs (unknown is never 0). Null (not_ready) where it is not computed yet. Null when unknown: unavailable_reasons names why (never 0 for unknown).

can be negative
realized_cum_fiat_unknown_legsinteger · unit count · can be null

How many disposal legs since the first acquisition are left out of realized_cum_fiat because their gain in the reporting currency is unknown (the cost of the units they took is unknown, or the TAO to reporting-currency rate is missing): their gain is not in it. Counted apart from the TAO legs: a missing rate leaves a leg out in the reporting currency only. 0 when every gain is known. Null (not_ready) where it is not computed yet.

income_emission_tao_raostring · unit rao (÷1e9) · can be null

Subnet emission received since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_root_tao_raostring · unit rao (÷1e9) · can be null

Root dividends received since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_growth_tao_raostring · unit rao (÷1e9) · can be null

Pool growth of every pool held (subnet alpha pools and root). Only its root part (income_root_growth_*) counts as income: growth of a subnet's alpha pool is value growth, already in the value and the unrealized gain, so it is not in the income totals. Since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_root_growth_tao_raostring · unit rao (÷1e9) · can be null

Root pool growth: the growth of the root stake pool, the part of pool growth (income_growth_*) that counts as income. 0 on every position outside root. Null (not_ready) where it is not computed yet. Since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_swap_misallocation_tao_raostring · unit rao (÷1e9) · can be null

Hotkey-swap misallocation: value gained when a hotkey swap, before the chain changed swaps in March 2026 to move stake by value, combined two stake pools without repricing their shares, so value moved from one pool's stakers to the other's; counted as income at its value when received, less any part the chain later took back. 0 for nearly every account. Received since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_fee_tao_raostring · unit rao (÷1e9) · can be null

Block-author fee share: the share of transaction fees paid to the block author, received to free TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

Format: whole number, as a string · on chain: u64
income_owner_tao_raostring · unit rao (÷1e9) · can be null

Subnet-owner emission: emission paid to a subnet owner's free TAO before dynamic TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

Format: whole number, as a string · on chain: u64
income_opening_tao_raostring · unit rao (÷1e9) · can be null

Pre-dTAO opening income: the lifetime income received through the 2025-02-12 UTC close (block 4,913,846, the last close before the dTAO launch at block 4,920,351), carried as one constant from the pre-dTAO boundary carry (income after that close is in the other parts), valued at receipt 1 TAO for 1 TAO. Present only on the TAO holder's root position (asset root, netuid 0, generation 0; 0 elsewhere), and also on a closed one when the holder's TAO left before the carry. Not a staking reward, and never in a day's figures (the series). TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_tao_raostring · unit rao (÷1e9) · can be null

All income since the first acquisition, TAO (rao): exactly subnet emission + root dividends + root pool growth + hotkey-swap misallocation + block-author fee share + subnet-owner emission (income_emission_* + income_root_* + income_root_growth_* + income_swap_misallocation_* + income_fee_* + income_owner_*). Growth of subnet alpha pools is not income, so the total is not the sum of all the parts when an alpha pool grew. While income_fee_* and income_owner_* are null (not_ready: not computed yet), the total leaves them out. On the TAO holder's root position the total also includes the pre-dTAO opening income (income_opening_*). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_unitsstring · unit lot_quantity (per quantity_unit)

All income since the first acquisition in units of the asset (quantity_unit): emission + root dividends + root pool growth + hotkey-swap misallocation + block-author fee share + subnet-owner emission + pre-dTAO opening (subnet alpha pool growth is not income). Never negative (>= 0).

Format: whole number, as a string
income_emission_fiatstring · unit ccy · can be null

Subnet emission received since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_root_fiatstring · unit ccy · can be null

Root dividends received since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_growth_fiatstring · unit ccy · can be null

Pool growth of every pool held (subnet alpha pools and root). Only its root part (income_root_growth_*) counts as income: growth of a subnet's alpha pool is value growth, already in the value and the unrealized gain, so it is not in the income totals. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_root_growth_fiatstring · unit ccy · can be null

Root pool growth: the growth of the root stake pool, the part of pool growth (income_growth_*) that counts as income. 0 on every position outside root. Null (not_ready) where it is not computed yet. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_swap_misallocation_fiatstring · unit ccy · can be null

Hotkey-swap misallocation: value gained when a hotkey swap, before the chain changed swaps in March 2026 to move stake by value, combined two stake pools without repricing their shares, so value moved from one pool's stakers to the other's; counted as income at its value when received, less any part the chain later took back. 0 for nearly every account. Received since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_fee_fiatstring · unit ccy · can be null

Block-author fee share: the share of transaction fees paid to the block author, received to free TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

income_owner_fiatstring · unit ccy · can be null

Subnet-owner emission: emission paid to a subnet owner's free TAO before dynamic TAO, income at its value when received (1 TAO for 1 TAO). On the TAO position only (asset root; 0 elsewhere). Not a staking reward. Received since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

income_opening_fiatstring · unit ccy · can be null

Pre-dTAO opening income: the lifetime income received through the 2025-02-12 UTC close (block 4,913,846, the last close before the dTAO launch at block 4,920,351), carried as one constant from the pre-dTAO boundary carry (income after that close is in the other parts), valued at receipt 1 TAO for 1 TAO. Present only on the TAO holder's root position (asset root, netuid 0, generation 0; 0 elsewhere), and also on a closed one when the holder's TAO left before the carry. Not a staking reward, and never in a day's figures (the series). In the reporting currency, valued at receipt; null (rate_unknown) where a receipt had no TAO-to-currency rate. Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_fiatstring · unit ccy · can be null

All income since the first acquisition, in the reporting currency: exactly subnet emission + root dividends + root pool growth + hotkey-swap misallocation + block-author fee share + subnet-owner emission (income_emission_* + income_root_* + income_root_growth_* + income_swap_misallocation_* + income_fee_* + income_owner_*). Growth of subnet alpha pools is not income, so the total is not the sum of all the parts when an alpha pool grew. While income_fee_* and income_owner_* are null (not_ready: not computed yet), the total leaves them out. On the TAO holder's root position the total also includes the pre-dTAO opening income (income_opening_*). Null when any of those parts is (other than a part not computed yet). Null when unknown: unavailable_reasons names why (never 0 for unknown).

staking_rewards_tao_raostring · unit rao (÷1e9) · can be null

Staking rewards: what staking paid, exactly subnet emission + root dividends + pool growth (income_emission_* + income_root_* + income_growth_*), pool growth being the rise in a validator pool's value per unit as rewards accrue to it (an accumulating fund). Price moves and hotkey-swap misallocation are not in it. Unlike the income totals (income_*, which follow the method in meta.lens), it counts all pool growth, subnet alpha pools' included. Since the first acquisition, at receipt value, TAO (rao). Never includes the block-author fee share or subnet-owner emission (income_fee_*, income_owner_*). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
staking_rewards_fiatstring · unit ccy · can be null

Staking rewards: what staking paid, exactly subnet emission + root dividends + pool growth (income_emission_* + income_root_* + income_growth_*), pool growth being the rise in a validator pool's value per unit as rewards accrue to it (an accumulating fund). Price moves and hotkey-swap misallocation are not in it. Unlike the income totals (income_*, which follow the method in meta.lens), it counts all pool growth, subnet alpha pools' included. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when any of those three parts is. Never includes the block-author fee share or subnet-owner emission (income_fee_*, income_owner_*). Null when unknown: unavailable_reasons names why (never 0 for unknown).

income_alpha_growth_tao_raostring · unit rao (÷1e9) · can be null

Alpha pool growth: the subnet alpha pools' part of pool growth, exactly income_growth_* - income_root_growth_*. Counted as appreciation, not income, under the fund method (meta.lens), so it is not in the income totals; it is in staking_rewards_*. 0 on root positions. Null (not_ready) where root pool growth is not computed yet. Since the first acquisition, at receipt value, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
income_alpha_growth_fiatstring · unit ccy · can be null

Alpha pool growth: the subnet alpha pools' part of pool growth, exactly income_growth_* - income_root_growth_*. Counted as appreciation, not income, under the fund method (meta.lens), so it is not in the income totals; it is in staking_rewards_*. 0 on root positions. Null (not_ready) where root pool growth is not computed yet. Since the first acquisition, in the reporting currency. Valued at receipt (the TAO price at the receipt's minute, in the reporting currency at that day's rate). Null when unknown: unavailable_reasons names why (never 0 for unknown).

external_in_tao_raostring · unit rao (÷1e9) · can be null

Value brought in from outside the account since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
external_out_tao_raostring · unit rao (÷1e9) · can be null

Value taken out of the account since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown).

Format: whole number, as a string · on chain: u64
burn_cost_tao_raostring · unit rao (÷1e9) · can be null

Burn cost: units burned, an expense of their value. On the TAO position (asset root): TAO burned (a burn, a registration or lock burn, a claim or escrow burn), 1 TAO for 1 TAO, in the reporting currency at the burn's minute. On an alpha position: the alpha burned or recycled, at its value at the burn's block. Each burn is also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). Spent since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

Format: whole number, as a string · on chain: u64
burn_cost_fiatstring · unit ccy · can be null

Burn cost: units burned, an expense of their value. On the TAO position (asset root): TAO burned (a burn, a registration or lock burn, a claim or escrow burn), 1 TAO for 1 TAO, in the reporting currency at the burn's minute. On an alpha position: the alpha burned or recycled, at its value at the burn's block. Each burn is also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). Spent since the first acquisition, in the reporting currency. Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

fee_cost_standalone_tao_raostring · unit rao (÷1e9) · can be null

Standalone fee cost: on the TAO position (asset root), the transaction fees paid in TAO (the transaction fee and EVM gas) netted per UTC day and booked when the day closes, at the day's mean TAO price in the reporting currency, plus EVM fee events at their minute; on an alpha position, the transaction fees paid in its alpha, at their value. An expense of its value, each also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). A swap's fee inside its proceeds is not a standalone fee and is not here. Spent since the first acquisition, TAO (rao). Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

Format: whole number, as a string · on chain: u64
fee_cost_standalone_fiatstring · unit ccy · can be null

Standalone fee cost: on the TAO position (asset root), the transaction fees paid in TAO (the transaction fee and EVM gas) netted per UTC day and booked when the day closes, at the day's mean TAO price in the reporting currency, plus EVM fee events at their minute; on an alpha position, the transaction fees paid in its alpha, at their value. An expense of its value, each also a disposal at the average basis, inside realized (P&L = gain - fee_cost_standalone - burn_cost). A swap's fee inside its proceeds is not a standalone fee and is not here. Spent since the first acquisition, in the reporting currency. Null when unknown: unavailable_reasons names why (never 0 for unknown). Null (not_ready) where it is not computed yet.

claims_receivable_tao_raostring · unit rao (÷1e9)

The open dissolution receivable: TAO that a removed subnet's pool still owes the account, between the subnet's removal (when the position in it was disposed of) and the payouts, held at its TAO amount (1 TAO = 1 TAO). It is part of the tao_claims position's units, not in addition to them: the account's TAO is root + tao_free + tao_claims, and this is the part of tao_claims still to be paid. When a payout lands, its amount moves to tao_free. 0 on every other position, and when nothing is owed. Always present, never absent: 0 while this figure is not yet computed: the ended position's alpha then stays held until the payouts arrive as tao_free. At most units on a tao_claims position. Never null.

Format: whole number, as a string · on chain: u64
unrealized_return_ratiostring · unit ratio · can be null

Unrealized return: unrealized_tao_rao / basis_tao_rao, signed, 8 decimals (0.25 = up 25% on cost). Null exactly with unrealized_return_unavailable_reason.

Format: decimal number, as a string · can be negative
unrealized_return_unavailable_reasonstring · can be null

Why unrealized_return_ratio is null; null when it is stated. no_basis: the basis is 0 (a closed position, or units held at no cost); basis_unknown: the basis or the unrealized gain is null; incomplete (summaries only): the summed basis or unrealized gain leaves positions out (complete false), so no ratio of partial sums is stated. New values may be added; treat unknown values as unavailable.

unrealized_return_fiat_ratiostring · unit ratio · can be null

Unrealized return in the reporting currency: unrealized_fiat / basis_fiat, signed, 8 decimals. Null exactly with unrealized_return_fiat_unavailable_reason.

Format: decimal number, as a string · can be negative
unrealized_return_fiat_unavailable_reasonstring · can be null

Why unrealized_return_fiat_ratio is null; null when it is stated. no_basis: the basis is 0 (a closed position, or units held at no cost); basis_unknown: the basis or the unrealized gain is null; incomplete (summaries only): the summed basis or unrealized gain leaves positions out (complete false), so no ratio of partial sums is stated. New values may be added; treat unknown values as unavailable.

mwr_ratiostring · unit ratio · can be null

Money-weighted return of this position in TAO over mwr_from_day..mwr_to_day (the whole period, not annualised), signed, 8 decimals (0.25 = up 25%). Null exactly with mwr_unavailable_reason, and without include=mwr. Money-weighted return (include=mwr): the return on the money actually put in, weighted by when and how much went in and came out. It is the internal rate of return (IRR) of the flows in and out and the value at the end when that has a unique solution, else the Modified Dietz return. Income received (emission, root dividends, root pool growth) counts as return, not as money put in. Stated over the period from the first money in (mwr_from_day) to mwr_to_day: the day asked, or for a closed position the day it closed (a closed position is measured through the day it closed). Annualised only over a period of at least 365 days, never over a shorter one. A position with under $1 invested is left out as dust: below_dust when it is also worth under $1, else no_invested_capital; a group's return leaves its dust out and counts it in mwr_dust_positions. carry_unknown on any member makes a group's return unavailable.

Format: decimal number, as a string · can be negative
mwr_annualized_ratiostring · unit ratio · can be null

mwr_ratio as a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly with mwr_annualized_unavailable_reason. Null without include=mwr.

Format: decimal number, as a string · can be negative
mwr_methodstring · can be null

How mwr_ratio is computed: irr (the internal rate of return, which has a unique solution here) or modified_dietz (the Modified Dietz return, where the IRR has none). Null when mwr_ratio is. New values may be added; show an unknown value as is (or generically).

mwr_unavailable_reasonstring · can be null

Why mwr_ratio is null; null when it is stated (and without include=mwr). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_annualized_unavailable_reasonstring · can be null

Why mwr_annualized_ratio is null; null when it is stated (and without include=mwr). The period return's reasons, and two of annualising: window_below_365_days (held under a year, so there is no yearly figure) and not_annualizable (the period lost 100% or more, so it has no yearly equivalent). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_fiat_ratiostring · unit ratio · can be null

Money-weighted return of this position in the reporting currency over mwr_from_day..mwr_to_day (the whole period, not annualised), signed, 8 decimals (0.25 = up 25%). Null exactly with mwr_fiat_unavailable_reason, and without include=mwr. Money-weighted return (include=mwr): the return on the money actually put in, weighted by when and how much went in and came out. It is the internal rate of return (IRR) of the flows in and out and the value at the end when that has a unique solution, else the Modified Dietz return. Income received (emission, root dividends, root pool growth) counts as return, not as money put in. Stated over the period from the first money in (mwr_from_day) to mwr_to_day: the day asked, or for a closed position the day it closed (a closed position is measured through the day it closed). Annualised only over a period of at least 365 days, never over a shorter one. A position with under $1 invested is left out as dust: below_dust when it is also worth under $1, else no_invested_capital; a group's return leaves its dust out and counts it in mwr_dust_positions. carry_unknown on any member makes a group's return unavailable.

Format: decimal number, as a string · can be negative
mwr_fiat_annualized_ratiostring · unit ratio · can be null

mwr_fiat_ratio as a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly with mwr_fiat_annualized_unavailable_reason. Null without include=mwr.

Format: decimal number, as a string · can be negative
mwr_fiat_methodstring · can be null

How mwr_fiat_ratio is computed: irr (the internal rate of return, which has a unique solution here) or modified_dietz (the Modified Dietz return, where the IRR has none). Null when mwr_fiat_ratio is. New values may be added; show an unknown value as is (or generically).

mwr_fiat_unavailable_reasonstring · can be null

Why mwr_fiat_ratio is null; null when it is stated (and without include=mwr). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_fiat_annualized_unavailable_reasonstring · can be null

Why mwr_fiat_annualized_ratio is null; null when it is stated (and without include=mwr). The period return's reasons, and two of annualising: window_below_365_days (held under a year, so there is no yearly figure) and not_annualizable (the period lost 100% or more, so it has no yearly equivalent). carry_unknown: part of the position arrived or left through a coldkey swap whose cost is not recorded yet, so the money put in or taken out is unknown; on a summary, any member's makes the group's return unavailable. below_dust: under $1 put in and under $1 now: left out as dust. no_invested_capital: none of the holder's own money was put in (emission only, or under $1 put in): left out as dust. incomplete_data: a price needed to value the position (at the start, on the day asked, or on a day units left without a trade) is missing. basis_unknown (reporting currency only): the rate to the reporting currency for some flow or value is missing; the TAO return may still be stated. flows_too_large: money moved in and out so heavily, against the capital held, that the Modified Dietz return would be a loss beyond -100%, which has no meaning. temporarily_unavailable: the return could not be computed in time; retry shortly (the rest of the answer is complete, and every return member carries this reason). New values may be added; treat unknown values as unavailable.

mwr_from_daystring (date) · can be null

The first day of the money-weighted return's period: the day of the first money in. Null without include=mwr.

Format: date, YYYY-MM-DD
mwr_to_daystring (date) · can be null

The last day of the money-weighted return's period: meta.day, or the day the position closed when it is closed. Null without include=mwr.

Format: date, YYYY-MM-DD
internal_transfer_basis_approxboolean

True when part of this basis moved in from another account at an approximate cost (the cost carried with a transfer between accounts is the sender's average, not the exact units).

basis_estimatedboolean

True when part of this basis is estimated: units received from another account (a transfer in, not one of the account's own moves) enter at their fair value at receipt, since what the sender paid is not the receiver's cost. The basis stays known; false on a closed position. Units received with no fair value are unvalued instead (unavailable_reasons).

unavailable_reasonsobject

Why each null figure is null: member name -> reason; {} when every figure is known. unvalued: some units entered with no known cost (no price paid on record, and no value at receipt or close price to stand in for one), so the basis and anything computed from it is unknown. price_unknown: the asset's close price that day is unknown, so its value is unknown in TAO and in the reporting currency. rate_unknown: the TAO figure is known, but the rate from TAO to the reporting currency it needs (at the close, or at the time of an acquisition, a disposal or a receipt) is not, so only the figure in the reporting currency is unknown. flows_unvalued: a flow is not valued: on a series row, the day's flows are not all valued (in the reporting currency: not yet), so the price effect and its split cannot be separated from them; on burn_cost_* and fee_cost_standalone_*, a burn or fee whose value is unknown. mixed_units (series): the row sums several assets or subnet lives, whose units are not comparable, so it has no unit count. not_ready: the figure is not computed yet. New values may be added; treat unknown values as unavailable.

Response headers

10 headers: ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
ETag

Strong validator of this answer. Send it back as If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.

Cache-Control

One of three classes: settled public, max-age=3600, stale-while-revalidate=86400 (pinned to a block that cannot move), slow public, max-age=300, stale-while-revalidate=600 (state that moves in minutes or days) or tip public, max-age=6, stale-while-revalidate=12 (follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Never immutable. no-store on an earlier answer served because the data source failed (X-BTAI-Stale).

CDN-Cache-Control

The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with stale-while-revalidate and stale-if-error; no-store with X-BTAI-Stale.

X-BTAI-Stale

Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then if-error, with X-BTAI-Stale-As-Of, Age (its seconds since then) and Warning: 110 - "Response is Stale", and Cache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.

X-BTAI-Stale-As-Of

With X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).

RateLimit-Policy

The tier's request quota of the current window (IETF draft), e.g. "tier";q=600.

RateLimit

Requests left in the current window and the seconds until it resets (IETF draft), e.g. "tier";r=597;t=42.

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503

304 Not Modified: the If-None-Match validator still matches; no body.

Error codes

The codes this endpoint can return. Each links to what it means and what to do.

From the API's published specification, version 1.165.0.