Get Wallet Cost Basis
https://api.bittensor.ai/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/batchform (up to 500). Omitted or empty: 400ADDRESSES_REQUIRED; an invalid entry: 400INVALID_ADDRESSnaming 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) orlp(liquidity positions). Default: every asset. Anything else is a 400INVALID_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
*_fiatamounts: an ISO 4217 code in upper case (defaultUSD), one ofmeta.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 400INVALID_CURRENCY.- dayquery· string
The UTC day,
YYYY-MM-DD, at its close (default: the newest available day,meta.through_day). Not a date, or beforemeta.coverage_from_day: a 400INVALID_DAY; aftermeta.through_day: a 503NOT_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 andlife_start_height) orasset. Default: not grouped (meta.groupsnull). Anything else is a 400INVALID_GROUP_BY.- group_limitquery· integer
With
group_by: keep the top N groups (1..1000) by TAO value on the last day served, plus oneothergroup summing the rest; 0 (the default) keeps every group. Out of range, or above 0 withoutgroup_by: a 400INVALID_GROUP_LIMIT.- include_closedquery· boolean · default false
Also list the closed positions (
is_openfalse: 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.totalsandmeta.groups, so the realized gain and income there are whole. Not true or false: a 400INVALID_BOOLEAN.- includequery· string
A comma list of optional sections:
mwradds the money-weighted return to every position, to each account'ssummary, tometa.totalsand tometa.groups(themwr_*members, null without it). Withinclude=mwrthe request takes at most 5 distinct addresses (more: a 400BATCH_TOO_LARGE). Anything else is a 400INVALID_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
completeis false.3 fields in basis_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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
completeis false.3 fields in basis_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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
completeis false.3 fields in value_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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
completeis false.3 fields in value_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause their figure is unknown.
- unrealized_tao_raoobject
Unrealized gain (value - basis), TAO (rao). Signed: with
completefalse, 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause their figure is unknown.
- unrealized_fiatobject
Unrealized gain (value - basis), in the reporting currency. Signed: with
completefalse, not a bound on the total.3 fields in unrealized_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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: withcompletefalse, 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.amountbecause 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: withcompletefalse, 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in income_fee_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in income_owner_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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. Whileincome_fee_*andincome_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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in income_fee_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in income_owner_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in income_opening_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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. Whileincome_fee_*andincome_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 inexcluded_positions).3 fields in income_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inmeta.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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inmeta.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 inexcluded_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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 thefundmethod (meta.lens), so it is not in the income totals; it is instaking_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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 thefundmethod (meta.lens), so it is not in the income totals; it is instaking_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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in burn_cost_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in burn_cost_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in fee_cost_standalone_tao_rao
- amountstring · unit rao (÷1e9)
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 inexcluded_positions.3 fields in fee_cost_standalone_fiat
- amountstring · unit ccy
The sum over the positions where this figure is known.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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_claimsposition's units, not in addition to them: the account's TAO isroot+tao_free+tao_claims, and this is the part oftao_claimsstill to be paid. When a payout lands, its amount moves totao_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 astao_free. Summed over the positions; already insidevalue_tao_rao(thetao_claimspositions' 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.
0when no position has it. Withcompletefalse it leaves outexcluded_positionspositions 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, withcompletefalse, a lower bound on the total. Unrealized and realized are signed: withcompletefalse 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_positionsis 0).- excluded_positionsinteger · unit count
How many positions are left out of
amountbecause 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 arecomplete. Null exactly withunrealized_return_unavailable_reason.- Format: decimal number, as a string · can be negative
- 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 arecomplete. Null exactly withunrealized_return_fiat_unavailable_reason.- Format: decimal number, as a string · can be negative
- 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 withmwr_unavailable_reason, and withoutinclude=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) tomwr_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_dustwhen it is also worth under $1, elseno_invested_capital; a group's return leaves its dust out and counts it inmwr_dust_positions.carry_unknownon any member makes a group's return unavailable. On theothergroup, null (its return is not computed).- Format: decimal number, as a string · can be negative
- mwr_annualized_ratiostring · unit ratio · can be null
mwr_ratioas a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly withmwr_annualized_unavailable_reason. Null withoutinclude=mwr. On theothergroup, null (its return is not computed).- Format: decimal number, as a string · can be negative
- mwr_methodstring · can be null
How
mwr_ratiois computed:irr(the internal rate of return, which has a unique solution here) ormodified_dietz(the Modified Dietz return, where the IRR has none). Null whenmwr_ratiois. New values may be added; show an unknown value as is (or generically).- 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 withmwr_fiat_unavailable_reason, and withoutinclude=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) tomwr_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_dustwhen it is also worth under $1, elseno_invested_capital; a group's return leaves its dust out and counts it inmwr_dust_positions.carry_unknownon any member makes a group's return unavailable. On theothergroup, 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_ratioas a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly withmwr_fiat_annualized_unavailable_reason. Null withoutinclude=mwr. On theothergroup, null (its return is not computed).- Format: decimal number, as a string · can be negative
- mwr_fiat_methodstring · can be null
How
mwr_fiat_ratiois computed:irr(the internal rate of return, which has a unique solution here) ormodified_dietz(the Modified Dietz return, where the IRR has none). Null whenmwr_fiat_ratiois. New values may be added; show an unknown value as is (or generically).- 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 withoutinclude=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 withoutinclude=mwr. On theothergroup, 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_approxon that position). Onmeta.totalsandmeta.groupsalso 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_estimatedon 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_positionsabove 0, the positions left out by reason (each position'sunavailable_reasons; the counts add up to that figure'sexcluded_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; onburn_cost_*andfee_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.summarysums 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_raois 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_freeandtao_claims.- generationinteger · unit id · can be null
Opaque life id (the life's registration identifier), NOT a block height; use
life_start_heightfor 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
generationnames (GET /subnets/generations'start_height): use it, nevergeneration, for heights, ages and dates. Null exactly whengenerationis null (root without a life, no subnet), or transiently when this API cannot read the lives. Root'sgeneration0 starts at 0.- is_current_lifeboolean · can be null
Whether
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 is current.- fund_hotkeyobject · can be null
The fund (its hotkey) on a
basketrow: one row per fund; null on every other asset. Abasketrow'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
unitsand 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 (
unitsnot 0). A closed position (false) is served only withinclude_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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_raobecause 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_reasonsnames 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_fiatbecause 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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. Whileincome_fee_*andincome_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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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. Whileincome_fee_*andincome_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_reasonsnames 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 inmeta.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_reasonsnames 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 inmeta.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_reasonsnames 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 thefundmethod (meta.lens), so it is not in the income totals; it is instaking_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_reasonsnames 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 thefundmethod (meta.lens), so it is not in the income totals; it is instaking_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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_reasonsnames 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_claimsposition's units, not in addition to them: the account's TAO isroot+tao_free+tao_claims, and this is the part oftao_claimsstill to be paid. When a payout lands, its amount moves totao_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 astao_free. At mostunitson atao_claimsposition. 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 withunrealized_return_unavailable_reason.- Format: decimal number, as a string · can be negative
- unrealized_return_fiat_ratiostring · unit ratio · can be null
Unrealized return in the reporting currency:
unrealized_fiat/basis_fiat, signed, 8 decimals. Null exactly withunrealized_return_fiat_unavailable_reason.- Format: decimal number, as a string · can be negative
- 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 withmwr_unavailable_reason, and withoutinclude=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) tomwr_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_dustwhen it is also worth under $1, elseno_invested_capital; a group's return leaves its dust out and counts it inmwr_dust_positions.carry_unknownon 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_ratioas a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly withmwr_annualized_unavailable_reason. Null withoutinclude=mwr.- Format: decimal number, as a string · can be negative
- mwr_methodstring · can be null
How
mwr_ratiois computed:irr(the internal rate of return, which has a unique solution here) ormodified_dietz(the Modified Dietz return, where the IRR has none). Null whenmwr_ratiois. New values may be added; show an unknown value as is (or generically).- 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 withmwr_fiat_unavailable_reason, and withoutinclude=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) tomwr_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_dustwhen it is also worth under $1, elseno_invested_capital; a group's return leaves its dust out and counts it inmwr_dust_positions.carry_unknownon 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_ratioas a yearly rate, signed, 8 decimals; stated only over a period of at least 365 days. Null exactly withmwr_fiat_annualized_unavailable_reason. Null withoutinclude=mwr.- Format: decimal number, as a string · can be negative
- mwr_fiat_methodstring · can be null
How
mwr_fiat_ratiois computed:irr(the internal rate of return, which has a unique solution here) ormodified_dietz(the Modified Dietz return, where the IRR has none). Null whenmwr_fiat_ratiois. New values may be added; show an unknown value as is (or generically).- 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 withoutinclude=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).
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), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, 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). Neverimmutable.no-storeon 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-revalidateandstale-if-error;no-storewithX-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, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-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.
- ADDRESSES_REQUIRED
- ADDRESS_NOT_IN_PLAN_SCOPE
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BATCH_TOO_LARGE
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_ADDRESS
- INVALID_ASSET
- INVALID_BOOLEAN
- INVALID_CURRENCY
- INVALID_DAY
- INVALID_GROUP_BY
- INVALID_GROUP_LIMIT
- INVALID_INCLUDE
- INVALID_NETUID
- NOT_READY
- PAYMENT_REQUIRED
- PLAN_REQUIRED
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.