Daily balance and value series of an account
https://api.bittensor.ai/api/v2/accounts/{address}/series- Status
- Beta
- Auth
- API key or OAuth access token
- Scope
data:read- Rate limit
plan
One row per UTC day, oldest first: the free and reserved TAO balances and the stake valued at the subnets' closing prices at the day's last block, the total, and TAO/USD at the day's close with the total in USD.
Full description
One row per UTC day, oldest first: the free and reserved TAO balances and the stake valued at the subnets' closing prices at the day's last block, the total, and TAO/USD at the day's close with the total in USD. When a subnet had no closing price, subnets_unpriced counts them and the stake and total are null (never a partial sum). The window is from_day..to_day, both inclusive (default: the last 30 computed days); days before the first computed day are not returned (the history reaches back to the first day any stake was held on chain), every day served is covered (a 0 is a real 0), and meta.from_day / meta.to_day echo the window actually served. At most 1000 days per request (400 RANGE_TOO_LARGE). Every row has day_status (closed | open) and as_of_height: when the window reaches today the last row is the OPEN row, dated meta.to_day + 1 and read at as_of_height (balances, stake, value_usd, since_close_return_ratio and the transfers since the last close; its returns null), never cached as settled. Each day also carries its return (stake_return_ratio), the USD return on the day-close basis (meta.usd_basis) and its TAO transfers (free_transfer_*). While no day has been computed yet the answer is 503 NOT_READY. Errors are application/problem+json: INVALID_ADDRESS, INVALID_DAY, INVALID_RANGE, INVALID_INTERVAL, RANGE_TOO_LARGE, UNKNOWN_PARAMETER, NOT_READY (503), SOURCE_NOT_READY (503). meta.final_through_day is the key to cache closed days by: the rows through it never change again (but by an announced rerun), so pass to_day = meta.final_through_day for an answer that never changes.
Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).
Path parameters
- addresspath, required· string
The account (coldkey): SS58, or 0x + 64 hex.
Query parameters
- from_dayquery· string (date)
First UTC day,
YYYY-MM-DD, inclusive. Default: 29 days beforeto_day.- Format: date, YYYY-MM-DD
- to_dayquery· string (date)
Last UTC day,
YYYY-MM-DD, inclusive. Default: the last computed day.- Format: date, YYYY-MM-DD
- intervalquery· string · default 1d
Row width;
1dis the only one served.
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 row per UTC day from meta.from_day to meta.to_day, oldest first; [] when the window holds no computed day. When the window reaches today the last row may be the OPEN row (day_status open, unfinished, dated meta.to_day + 1, as of as_of_height).
- stake_price_effect_usdstring · unit usd · 2 decimals · can be null
The day's price effect on the held stake (
stake_price_effect_tao_raoon the portfolio series; on an account's series the portfolio series' figure for the same account and day) in USD at that day'stao_usd(the TAO/USD close), 2 decimals, signed. Null when the TAO figure ortao_usdis, and on an open row. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- stake_income_incl_accrued_usdstring · unit usd · 2 decimals · can be null
The day's income including rewards earned and claimable at will, not yet claimed (
stake_income_incl_accrued_tao_rao) in USD at that day'stao_usd(the TAO/USD close), 2 decimals, signed. Null when the TAO figure ortao_usdis, and on an open row.- Format: decimal number, as a string · can be negative
- stake_price_effect_incl_accrued_usdstring · unit usd · 2 decimals · can be null
The day's price effect including rewards earned and claimable at will, not yet claimed (
stake_price_effect_incl_accrued_tao_rao) in USD at that day'stao_usd(the TAO/USD close), 2 decimals, signed. Null when the TAO figure ortao_usdis, and on an open row. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- stake_growth_usdstring · unit usd · 2 decimals · can be null
The day's pool growth (
stake_growth_tao_rao): the rise in value per unit of the validator pools held, as rewards accrue to them (nominator dividends), excluding price moves; on an account's series the portfolio series' figure for the same account and day. in USD at that day'stao_usd(the TAO/USD close), 2 decimals, signed. Null when the TAO figure ortao_usdis, and on an open row. Null on an older data version's answer. Staking rewards in USD =stake_income_incl_accrued_usd+stake_growth_usd.- Format: decimal number, as a string · can be negative
- accrued_claimable_tao_raostring · unit rao (÷1e9) · can be null
The accrued claimable at the day's close, in rao of TAO:
accrued_claimable_root_tao_rao+accrued_claimable_basket_tao_rao. "0" only where nothing can be owed (before 2025-11-04, when root dividends were paid into the stake, or no root stake and no fund units). Its own figure: never intotal_spot_tao_raoor the balances. Null withaccrued_unavailable_reason. Accrued means earned and claimable at will, not yet claimed: from 2025-11-04 to 2026-08-02 the root claimable (alpha of each subnet, valued at that subnet's per-unit fair value at the day's close), from 2026-08-03 the units the root basket funds owe (valued at each fund's fair-value NAV per unit at the close: its holdings at fair value). Amounts below the chain's claim threshold are included.- Format: whole number, as a string · on chain: u64
- accrued_claimable_root_tao_raostring · unit rao (÷1e9) · can be null
The root-claimable part of
accrued_claimable_tao_rao(2025-11-04 to 2026-08-02), in rao of TAO: each subnet's owed alpha at that subnet's fair value at the close. "0" on other days.- Format: whole number, as a string · on chain: u64
- accrued_claimable_basket_tao_raostring · unit rao (÷1e9) · can be null
The basket part of
accrued_claimable_tao_rao(from 2026-08-03), in rao of TAO: the fund units owed at each fund's fair-value NAV per unit at the close. "0" on earlier days.- Format: whole number, as a string · on chain: u64
- accrued_income_tao_raostring · unit rao (÷1e9) · can be null
The day's accrual, in rao of TAO: the claimable newly earned that day (root claimable or fund units), valued at the day's close fair value (the day's accrual is valued once a day, at the close, not at each credit's block). Income in the performance view: counted when earned, not when claimed. It includes the claimable a coldkey swap created on the new coldkey (runtime spec 334-440): other income on the swap day, never emission. Null on the first computed day and with
accrued_unavailable_reason. On 2026-08-03 the root claimable was converted into basket units on chain; that day's accrual, claims, forfeits and claim cost cannot be told apart and are null (accrued_unavailable_reasonconversion_day); the stock, the value, the return and the P&L are served.- Format: whole number, as a string · on chain: u64
- accrued_claimed_tao_raostring · unit rao (÷1e9) · can be null
The accrued claimable that claims released to the held stake that day, in rao of TAO (root claims at their value at the claim; basket claims: the units claimed at the close fair value). A move from accrued to held: not income and not a gain. On 2026-08-03 the root claimable was converted into basket units on chain; that day's accrual, claims, forfeits and claim cost cannot be told apart and are null (
accrued_unavailable_reasonconversion_day); the stock, the value, the return and the P&L are served.- Format: whole number, as a string · on chain: u64
- accrued_forfeited_tao_raostring · unit rao (÷1e9) · can be null
The accrued root claimable that unstakes destroyed that day (2025-11-04 to 2026-08-02), at the close fair value, in rao of TAO: a loss. "0" on other days.
root_claimable_forfeited_tao_raokeeps its own valuation (the close price). On 2026-08-03 the root claimable was converted into basket units on chain; that day's accrual, claims, forfeits and claim cost cannot be told apart and are null (accrued_unavailable_reasonconversion_day); the stock, the value, the return and the P&L are served.- Format: whole number, as a string · on chain: u64
- accrued_claim_cost_tao_raostring · unit rao (÷1e9) · can be null
The claims' cost that day, in rao of TAO, signed (it can be negative): what the claims released at the close fair value less what they paid out. A basket claim sells the fund's holdings, so it usually pays a little less than their fair value. On a closed day of the
root_claimableera (through 2026-08-02), a current answer (itsfv_level_mixcarriesvalue_l3_tao_rao) also counts each root claim taken as a swap: the fair value released less the root TAO credited. An older answer serves "0" for root claims there. Keep claims cost "0", as do days without a claim. Null where the claims are not available or not priced (accrued_unavailable_reason). Insidestake_price_effect_incl_accrued_tao_rao. On 2026-08-03 the root claimable was converted into basket units on chain; that day's accrual, claims, forfeits and claim cost cannot be told apart and are null (accrued_unavailable_reasonconversion_day); the stock, the value, the return and the P&L are served.- Format: whole number, as a string · can be negative
- value_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The performance view's value at the close, in rao of TAO: the same base as the held return (
stake_return_ratio: the stake at the close price,stake_spot_tao_rao, plus the liquidity positions) plusaccrued_claimable_tao_rao, the accrued claimable at its per-unit fair value. So it differs from the held base only by the accrued claimable. The value the*_incl_accruedreturns are measured on; not a balance (total_spot_tao_raostays held-only). Served whenever the accrued part is, an older answer's thin-pool day (fv_reasonthin_pool) included; null when the accrued claimable or the held base is. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · on chain: u64
- stake_prev_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The previous close's
value_incl_accrued_tao_rao, in rao of TAO: the base ofstake_return_incl_accrued_ratio. Additive across disjoint address sets. Null on the first computed day or when the previous close's value is unknown. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · on chain: u64
- stake_net_flow_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The day's external flows in the performance view, in rao of TAO, signed:
stake_net_flow_tao_raoless the basket claims' proceeds (from 2026-08-03 a basket claim moves value from accrued to held inside the portfolio; it is not money in). It also carries the accrued claimable a coldkey swap moved that day, as a transfer between the two wallets (+ into the new coldkey, - out of the old; a set holding both nets it to 0), never income or a price effect. Null when the flow is. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · can be negative
- stake_income_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The day's income in the performance view, in rao of TAO, signed:
stake_income_tao_raoless the root claims booked as income that day, plusaccrued_income_tao_rao(root income counts when it accrues, not at the claim). On 2026-08-03 the day's accrual cannot be split out and sits instake_price_effect_incl_accrued_tao_rao. Null on the first computed day (no previous close), when the day's or the previous close's accrued figures are unknown (accrued_unavailable_reason), wherever the held figures are withheld (on an older answer a thin-pool day,fv_reasonthin_pool;accrued_unavailable_reasonsaysthin_pooltoo) and on an open row.- Format: whole number, as a string · can be negative
- stake_price_effect_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The rest of the day's change in
value_incl_accrued_tao_rao, in rao of TAO, signed, so thatvalue_incl_accrued_tao_rao-stake_prev_incl_accrued_tao_rao=stake_net_flow_incl_accrued_tao_rao+stake_growth_tao_rao+stake_income_incl_accrued_tao_rao+stake_fee_tao_rao+stake_other_tao_rao+ this, to the rao: the repricing of the held stake (at the close price, as instake_price_effect_tao_rao) and of the accrued claimable (at its per-unit fair value), forfeits (also shown inaccrued_forfeited_tao_rao), the claims' cost (accrued_claim_cost_tao_rao) and rounding. On 2026-08-03 it also holds the conversion's step and the day's accrual. Null on the first computed day (no previous close), when the day's or the previous close's accrued figures are unknown (accrued_unavailable_reason), wherever the held figures are withheld (on an older answer a thin-pool day,fv_reasonthin_pool;accrued_unavailable_reasonsaysthin_pooltoo) and on an open row. Null when the day's income is not known (income_unavailable_reason) or its earnings are not, since the price effect is what remains after income. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · can be negative
- stake_pnl_incl_accrued_tao_raostring · unit rao (÷1e9) · can be null
The day's gain in the performance view, in rao of TAO, signed:
stake_growth_tao_rao+stake_income_incl_accrued_tao_rao+stake_fee_tao_rao+stake_price_effect_incl_accrued_tao_rao(stake_other_tao_raoexcluded, as instake_pnl_tao_rao). A claim is not a gain. Null on the first computed day (no previous close), when the day's or the previous close's accrued figures are unknown (accrued_unavailable_reason), wherever the held figures are withheld (on an older answer a thin-pool day,fv_reasonthin_pool;accrued_unavailable_reasonsaysthin_pooltoo) and on an open row. Null when the day's income is not known (income_unavailable_reason) or its earnings are not, since the price effect is what remains after income. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · can be negative
- stake_pnl_incl_accrued_usdstring · unit usd · 2 decimals · can be null
stake_pnl_incl_accrued_tao_raoin USD at that day'stao_usd, 2 decimals, signed. Null when either is. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- stake_return_incl_accrued_ratiostring · unit ratio · 8 decimals · can be null
The day's time-weighted return in the performance view, 8 decimals, signed: (
stake_growth_tao_rao+stake_fee_tao_rao+stake_price_effect_incl_accrued_tao_rao+accrued_income_tao_rao) /stake_prev_incl_accrued_tao_rao, flows at the close: the held return's base (the stake at the close price plus the liquidity positions) plus the accrued claimable at its per-unit fair value. Accrued income is in the return (it is earned on the capital held); minted service income andstake_other_tao_raoare not, as instake_return_ratio. Null when the previous close's value including accrued is below 0.001 TAO (dust), and otherwise asstake_price_effect_incl_accrued_tao_rao. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- stake_return_incl_accrued_usd_ratiostring · unit ratio · 8 decimals · can be null
stake_return_incl_accrued_ratioin USD terms: (1 +stake_return_incl_accrued_ratio) xtao_usd/ the previous close'stao_usd- 1, 8 decimals, signed. Null when the TAO return or either rate is. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- close_sourcestring · can be null
Where the row's figures come from (an opaque identifier):
batch(a closed row from the daily close),candidate(reserved: an early close published ahead of the daily close),open(an open row: yesterday's before its close, or today's). Always given. New values may be added; show an unknown value as is (or generically).- close_as_of_heightinteger · unit block · can be null
The block the row's figures are as of: the day's last block on a closed row (
day_end_height),as_of_heighton an open row. Always given.- lp_position_spot_tao_raostring · unit rao (÷1e9) · can be null
The Swap liquidity-provider positions AT MARK: their value at the day's close, in rao of TAO (the TAO leg plus the alpha leg at the close price). When available it replaces
lp_position_cost_tao_raoin the total (lp_position_basismark). "0" outside the LP days (2025-07-08 to 2026-01-05) and on the open rows (no position can be open); null withlp_position_spot_unavailable_reasonwhile the mark isn't available yet. Basis: always the close mark (the alpha leg at the close price), whatevermeta.valuation_standardsays; the returns' liquidity sleeve uses the same mark (a disclosed departure from fair value).- Format: whole number, as a string · on chain: u64
- lp_position_spot_alpha_raostring · unit alpha_rao (÷1e9) · can be null
The alpha leg of the LP positions at the day's close, in alpha rao; null and "0" as
lp_position_spot_tao_rao. Basis: always the close mark (the alpha leg at the close price), whatevermeta.valuation_standardsays; the returns' liquidity sleeve uses the same mark (a disclosed departure from fair value).- Format: whole number, as a string · on chain: u64
- lp_position_spot_tao_leg_raostring · unit rao (÷1e9) · can be null
The TAO leg of the LP positions at the day's close, in rao; null and "0" as
lp_position_spot_tao_rao. Basis: always the close mark (the alpha leg at the close price), whatevermeta.valuation_standardsays; the returns' liquidity sleeve uses the same mark (a disclosed departure from fair value).- Format: whole number, as a string · on chain: u64
- lp_position_basisenum · can be null
How the LP positions enter
total_spot_tao_rao:mark(lp_position_spot_tao_rao) when available, elsecost(lp_position_cost_tao_rao) when available. Neither is a lower bound (cost is not a floor on market value). The same basis values the day in the totals and in the return decomposition. Null outside the LP days (2025-07-08 to 2026-01-05), on the open rows, for an address that held no LP position that day, and when the LP counts 0 (neither figure available, or the LP kept at 0 while the mark is served for information): thentotal_is_lower_boundis true. A day row's basis is the weakest across its LP-holding addresses (null < cost < mark), its total their totals summed.- One of:
mark,cost - stake_level3_spot_tao_raostring · unit rao (÷1e9) · can be null
The part of
stake_spot_tao_raovalued at a fair-value Level-3 price (no observable pool price), in rao of TAO. RESERVED: null withstake_level3_unavailable_reasonnot_readywhile the data isn't available yet, never 0 for unknown; it then fills with no format change. Basis: always the close price (spot), whatevermeta.valuation_standardsays.- Format: whole number, as a string · on chain: u64
- free_burn_raostring · unit rao (÷1e9) · can be null
TAO burned from the free balance, in rao: a registration's recycled TAO (what the payer moved to the subnet account less its collateral stake),
Balances.Burned,add_stake_burn's TAO. Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_burn_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_evm_bridge_in_raostring · unit rao (÷1e9) · can be null
TAO into the free balance from the EVM side, in rao: EVM gas refunds, 0x800 precompile transfers received, stake removed through the staking precompile (0x805 / 0x801), bridge-escrow releases. A plain EVM value transfer between two mirror accounts is a transfer. Gas is gross: net gas =
free_evm_bridge_out_raominus the refunds. Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_evm_bridge_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_evm_bridge_out_raostring · unit rao (÷1e9) · can be null
TAO out of the free balance to the EVM side, in rao: EVM gas pre-charges, 0x800 precompile transfers sent, stake added through the staking precompile, the whole
msg.valueinto a bridge escrow (the LayerZero fee inside it). Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_evm_bridge_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_stake_buy_raostring · unit rao (÷1e9) · can be null
TAO from the free balance into stake, in rao: stake, limit and basket transfers to a subnet account, a registration's collateral stake, pre-dTAO
add_stakewithdrawals. Staking through the EVM precompile is infree_evm_bridge_out_rao. Internal to the total value (free to stake). Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_stake_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_stake_sell_raostring · unit rao (÷1e9) · can be null
TAO into the free balance out of stake, in rao: unstake proceeds, pre-dTAO
remove_stakedeposits and the stake returned on deregistration. Unstaking through the EVM precompile is infree_evm_bridge_in_rao. Internal to the total value (stake to free). Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_stake_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_other_in_raostring · unit rao (÷1e9) · can be null
Any other TAO into the free balance, in rao: subnet lock refunds, dissolution payouts, crowdloan refunds and payouts, coldkey-swap moves, the block author's fee share, Swap LP principal and fees, the genesis balance, pre-dTAO subnet-owner emission, 0x80a / 0x80b precompile moves. Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null with
free_other_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_other_out_raostring · unit rao (÷1e9) · can be null
Any other TAO out of the free balance, in rao: subnet locks, crowdloan contributions, coldkey-swap moves and costs, Swap LP principal, contract storage deposits, dust lost, 0x80a / 0x80b precompile moves. Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null with
free_other_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · on chain: u64
- free_unexplained_raostring · unit rao (÷1e9) · can be null
The residual: the day's change in free + reserved (
System.Accountat the day's last block against the previous day's) minus every leg above, the transfers andfee_tx_tao_rao(the transaction fees paid from free), in rao, signed; "0" when the decomposition is complete. Checked every night. Served on a closed day whose free-flow figures are available (and on the account series' rows, which copy the portfolio row of the address and day): then every free leg of the row is served together, "0" without one. Null withfree_unexplained_unavailable_reasonnot_readyon a closed day whose figures aren't available yet (every closed day of a portfolio window whose closed days are not all available: one meaning per answer), and withday_not_closedon the open rows (the free-flow group counts only at a close; the account series' open row the same); never 0 for unknown. The day's on a row or wallet; in the portfolio series'meta.totalsthe covered (closed) days' sum only when every covered day is available, else null withnot_ready(never a partial sum).- Format: whole number, as a string · can be negative
- daystring (date)
The UTC day (YYYY-MM-DD); a closed day's values are at its last block, the open row's at
as_of_height.- Format: date, YYYY-MM-DD
- day_statusstring
closed: a finished UTC day, at its last block.open: today, unfinished (see the open row below). The OPEN row is today, unfinished: the last row, served when the window reaches today (on the portfolio series only for 50 accounts or fewer). Its day ismeta.to_day+ 1 (meta.to_daystays the last closed day), and every value on it is read atas_of_height, the newest block both the chain state and the share flows cover: the balances, stake and total, the net flow and fee since the close,stake_prev_spot_tao_rao(the last close's stake),value_usd,tao_usd,since_close_return_ratioand the transfers since the close (null on the open rows with the rest of the free-flow group,day_not_closed).wallets,subnets,holds_root_stake, the basket and root-accrual legs and every earnings, return and P&L field are null on it, and it is in no total: never read it as a finished day. New values may be added; show an unknown value as is (or generically).- as_of_heightinteger · unit block · can be null
The block every value on the row is read at: a closed day's last block (
day_end_height, the UTC day's last block, on both series), the open row's newest block both the chain state and the share flows cover.- free_raostring · unit rao (÷1e9) · can be null
Free TAO balance at the day's end, in rao.
- Format: whole number, as a string · on chain: u64
- reserved_raostring · unit rao (÷1e9) · can be null
Reserved TAO balance at the day's end, in rao.
- Format: whole number, as a string · on chain: u64
- stake_spot_tao_raostring · unit rao (÷1e9) · can be null
Sum over the day's positions of alpha x the subnet's closing price, in rao of TAO: a spot valuation, not an exit value. Null when
subnets_unpriced> 0 (never a partial sum: the total carries the priced part, flaggedtotal_is_lower_bound). Basis: always the close price (spot), whatevermeta.valuation_standardsays.- Format: whole number, as a string · on chain: u64
- root_spot_tao_raostring · unit rao (÷1e9) · can be null
The root stake (subnet 0) at the day's close, in rao of TAO (root alpha is TAO, so no price applies). Part of
stake_spot_tao_rao, never more than it.0when the account held no root stake. Never null on a closed day; null on the open row (root_spot_unavailable_reason).- Format: whole number, as a string · on chain: u64
- root_spot_usdstring · unit usd · 6 decimals · can be null
root_spot_tao_raoin USD at that day'stao_usd(an amount), 6 decimals. Null when either is null.- Format: decimal number, as a string
- stake_growth_tao_raostring · unit rao (÷1e9) · can be null
Pool growth: the rise in value per unit of the validator pools the account holds, as rewards accrue to them (nominator dividends), valued at the day's close, in rao of TAO, signed. Excludes price moves. Staking rewards =
stake_income_incl_accrued_tao_rao+stake_growth_tao_rao. Null when a pool the account holds cannot be valued at the close (missing chain data; on an older answer also anL3pool,fv_reasonthin_pool), and on an older data version's answer.- Format: whole number, as a string · can be negative
- positionsinteger · unit count · can be null
Number of stake positions at the day's end. Never null on a closed day; the open row may leave it null.
- subnets_unpricedinteger · unit count · can be null
How many subnets the account held stake in had no closing price that day. When above 0,
stake_spot_tao_raois null andtotal_spot_tao_raoleaves those positions out (total_is_lower_bound). Counts subnets, not positions (/accounts/{address}counts positions). Never null on a closed day; the open row may leave it null.- basket_entitlement_missingboolean · can be null
True on a day the account held root stake but its basket entitlement is not available for that day (
basket_entitlement_spot_tao_raonull). Never affects the total. Never null on a closed day; the open row may leave it null.- total_spot_tao_raostring · unit rao (÷1e9) · can be null
SETTLED value: free + reserved + the priced positions at the day's close, in rao. Never null on a closed day: a lower bound when
total_is_lower_bound(an unpriced subnet's positions are left out). The open row may leave it null; when given it is free + reserved + stake as ofas_of_height. The basket entitlement is never in it (unrealized: a claim costs fees and has a threshold); it is its own series,basket_entitlement_spot_tao_rao. On the LP days (2025-07-08 to 2026-01-05) it also includeslp_position_cost_tao_rao(the open liquidity positions at cost), so it equals the portfolio series' total for the same account and day; while the cost is not available (null withnot_ready) the total is without it. The LP part is at mark when available (lp_position_basismark), else at cost (cost), else 0 (total_is_lower_boundtrue). Basis: always the close price (spot), whatevermeta.valuation_standardsays.- Format: whole number, as a string · on chain: u64
- lp_position_cost_tao_raostring · unit rao (÷1e9) · can be null
The account's open Swap liquidity-provider positions carried at COST, in rao of TAO (the portfolio series' value for the same account and day): the deposited TAO plus the deposited alpha at the pool price of the deposit block, never re-priced (not a market value), constant until a withdrawal. "0" with no open position and on the open row. On the LP days (2025-07-08 to 2026-01-05) it is inside
total_spot_tao_raoandtotal_spot_usd. Null withlp_position_cost_unavailable_reason.- Format: whole number, as a string · on chain: u64
- total_is_lower_boundboolean · can be null
True when
total_spot_tao_raois a lower bound: a subnet was unpriced that day (subnets_unpriced> 0; the total omits its positions, andstake_spot_tao_raois null), or an LP-era day (2025-07-08 to 2026-01-05) whoselp_position_cost_tao_raois not known (null with its reason): the open liquidity positions at cost are missing from the total. It applies tototal_spot_usdand to this API'stotal_incl_unclaimed_spot_tao_rao/_usdtoo (computed from the total). Never null on a closed day; the open row may leave it null. It is true ONLY when a leg is genuinely missing and counted 0: an address that held an LP position that day whose LP counts 0 (neither mark nor cost available, or the LP kept at 0 while the mark is served for information); LP at cost or at mark is not a lower bound. A wallet that held no LP position is never flagged for it; a day row's flag is its wallets' OR.- basket_entitlement_spot_tao_raostring · unit rao (÷1e9) · can be null
The day's UNREALIZED basket entitlement, rao: the units the root validators' basket funds owe the account at the day end x each fund's spot NAV per unit then. Its own series, never included in
total_spot_*. Null when none is owed or the day is not available (basket_entitlement_missing). Basis: always the close price (spot), whatevermeta.valuation_standardsays.- Format: whole number, as a string · on chain: u64
- root_claimable_accrued_tao_raostring · unit rao (÷1e9) · can be null
The account's root earnings on the accrual basis that day, rao: the basket units its validators' funds newly owe it, at the realizable NAV. UNREALIZED until claimed: its own field, never included in
total_spot_*. The same meaning as the portfolio series' field of this name, in every root-dividend era: "0" on a known day with nothing owed (and in thein_stakeera, where the dividends are inside the stake earnings), the root claimable newly accrued in theroot_claimableera. Null only on the first computed day, when a fund or that day's accrual is unpriced or not yet available (unknown, never 0).- Format: whole number, as a string · on chain: u64
- tao_usdstring · unit usd_per_tao · can be null
TAO/USD at the day's close (USD per 1 TAO, a price). Null when no price exists for that minute.
- Format: decimal number, as a string
- total_spot_usdstring · unit usd · 6 decimals · can be null
total_spot_tao_raoin USD at that day'stao_usd(an amount), 6 decimals. Null exactly whentao_usdis (and on the open row when its total is null). It includes the LP positions at cost on the LP days, as the total does. Basis: always the close price (spot), whatevermeta.valuation_standardsays.- Format: decimal number, as a string
- total_incl_unclaimed_spot_tao_raostring · unit rao (÷1e9) · can be null
Total including unclaimed root rewards (
basket_entitlement_spot_tao_rao): not yet claimed and not liquid until claimed; the plain total excludes them.total_spot_tao_rao+basket_entitlement_spot_tao_rao, in rao. A null entitlement counts 0 only whenbasket_entitlement_missingis false (none owed); null when it is true or null, and always on the open row (which never carries the entitlement). A lower bound whenevertotal_is_lower_boundis true (it is computed from that total). Null when either part is null (an unknown unclaimed amount never counts as 0); equal tototal_spot_tao_raowhenbasket_entitlement_spot_tao_raois0. Computed by this API from the served fields.- Format: whole number, as a string · on chain: u64
- total_incl_unclaimed_spot_usdstring · unit usd · 6 decimals · can be null
Total including unclaimed root rewards (
basket_entitlement_spot_tao_rao): not yet claimed and not liquid until claimed; the plain total excludes them.total_incl_unclaimed_spot_tao_raoin USD at that day'stao_usd, the pricetotal_spot_usduses (6 decimals, half away from zero). Null when either is null; equal tototal_spot_usdwhenbasket_entitlement_spot_tao_raois0. Computed by this API.- Format: decimal number, as a string
- value_usdstring · unit usd · can be null
The stake (
stake_spot_tao_rao) in USD at the row's TAO/USD: the day's close, the open row'sas_of_height. Null when either is. Basis: always the close price (spot):stake_spot_tao_raox the day's TAO/USD rate, whatevermeta.valuation_standardsays; it is not the base of any return.- Format: decimal number, as a string · can be negative
- stake_return_ratiostring · unit ratio · can be null
The stake's return that day (the portfolio series'
stake_return_ratiofor this one account): (growth + fee + price effect) / the previous close's stake, net of fees; minted income is income, never return. Null on the first computed day, when the previous close holds no stake, or on the open row. Null when the day's income is not known (income_unavailable_reason) or its earnings are not, since the price effect is what remains after income. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- stake_return_usd_ratiostring · unit ratio · can be null
The day's return in USD on the day-close basis (
meta.usd_basis): (1 +stake_return_ratio) xtao_usd/ the previous close'stao_usd- 1. Flows and income are at the close, as in the TAO series. Null when the TAO return or either TAO/USD close is, or on the open row. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: decimal number, as a string · can be negative
- since_close_return_ratiostring · unit ratio · can be null
The open row only (null on every closed row): (the stake now - the last close's stake - the stake flows since) / the last close's stake, a ratio; the fees paid since are a cost, in it. Unfinished, in no total. Basis: always the close price (spot), whatever
meta.valuation_standardsays: the day so far, its flows priced at their own blocks.- Format: decimal number, as a string · can be negative
- free_transfer_in_raostring · unit rao (÷1e9) · can be null
TAO received by transfer that day (the open row: since the last close), in rao. Ordinary
Balances.Transferonly: a module account's side (stake mechanics) is not a transfer; EVM mirror-to-mirror value transfers are always included. Two meanings, told apart by the row'sfree_evm_bridge_unavailable_reason. Null (a closed day whose free-flow figures are available, and the account series' rows copied from it): transfers with an ordinary account only; the EVM crossings (0x800 balance-transfer precompile transfers, bridge-escrow deposits and releases, mirror-to-SS58 dispatches) are infree_evm_bridge_in_rao/free_evm_bridge_out_raoinstead.not_ready(every closed day of a portfolio window whose closed days' free-flow figures are not all available yet: one meaning per answer): every ordinary transfer, EVM crossings included.day_not_closed(the open rows, on both series): null, the transfers count only at a close (close_only_unavailable_reasonday_not_closedon the portfolio row). Null otherwise only on the first computed day (no previous close); "0" / 0 on a later day without transfers.- Format: whole number, as a string · on chain: u64
- free_transfer_out_raostring · unit rao (÷1e9) · can be null
TAO sent by transfer that day (the open row: since the last close), in rao. Ordinary
Balances.Transferonly: a module account's side (stake mechanics) is not a transfer; EVM mirror-to-mirror value transfers are always included. Two meanings, told apart by the row'sfree_evm_bridge_unavailable_reason. Null (a closed day whose free-flow figures are available, and the account series' rows copied from it): transfers with an ordinary account only; the EVM crossings (0x800 balance-transfer precompile transfers, bridge-escrow deposits and releases, mirror-to-SS58 dispatches) are infree_evm_bridge_in_rao/free_evm_bridge_out_raoinstead.not_ready(every closed day of a portfolio window whose closed days' free-flow figures are not all available yet: one meaning per answer): every ordinary transfer, EVM crossings included.day_not_closed(the open rows, on both series): null, the transfers count only at a close (close_only_unavailable_reasonday_not_closedon the portfolio row). Null otherwise only on the first computed day (no previous close); "0" / 0 on a later day without transfers.- Format: whole number, as a string · on chain: u64
- free_transfer_countinteger · unit count · can be null
Transfers in + out that day (the open row: since the last close). Ordinary
Balances.Transferonly: a module account's side (stake mechanics) is not a transfer; EVM mirror-to-mirror value transfers are always included. Two meanings, told apart by the row'sfree_evm_bridge_unavailable_reason. Null (a closed day whose free-flow figures are available, and the account series' rows copied from it): transfers with an ordinary account only; the EVM crossings (0x800 balance-transfer precompile transfers, bridge-escrow deposits and releases, mirror-to-SS58 dispatches) are infree_evm_bridge_in_rao/free_evm_bridge_out_raoinstead.not_ready(every closed day of a portfolio window whose closed days' free-flow figures are not all available yet: one meaning per answer): every ordinary transfer, EVM crossings included.day_not_closed(the open rows, on both series): null, the transfers count only at a close (close_only_unavailable_reasonday_not_closedon the portfolio row). Null otherwise only on the first computed day (no previous close); "0" / 0 on a later day without transfers.- fee_tx_tao_raostring · unit rao (÷1e9) · can be null
Transaction fees the account paid in TAO that day, as a positive amount paid (unsigned), in rao (the portfolio series'
fee_tx_tao_raofor this one account): the fees of the extrinsics it paid for (as the signer, or as a proxy's real account; the tip included), without the fees the chain took in alpha (those arefee_tx_alpha_tao_rao). A cost of the free balance, outside stake: in no stake figure. On the open row: today so far, as ofas_of_height, by the same rules (alpha at that block's price); null withfee_unavailable_reasontoo_many_rowswhen the account paid over 200 transaction fees since the last close. Null on the series' first day and on a day whose account-day figures aren't available.- Format: whole number, as a string · on chain: u64
- fee_tx_alpha_tao_raostring · unit rao (÷1e9) · can be null
Transaction fees the account paid in alpha that day, each subnet's alpha at its closing price, in rao of TAO, as a positive amount paid (the portfolio series'
fee_tx_alpha_tao_rao, itsstake_fee_tao_raonegated, for this one account). Negative only when a fee refunded after dispatch exceeded that day's fees. Already inside the stake andstake_return_ratio: never add it again. On the open row: today so far, as ofas_of_height, by the same rules (alpha at that block's price); null withfee_unavailable_reasontoo_many_rowswhen the account paid over 200 transaction fees since the last close. Null where the portfolio series'stake_fee_tao_raois null. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · can be negative
- fee_swap_tao_raostring · unit rao (÷1e9) · can be null
The pool's swap fees on the trades the account paid for that day (buy, sell and both legs of a swap, charged to the payer: the account whose stake is sold; a stake transfer's recipient gets the net and is charged nothing), as a positive amount paid (unsigned), in rao of TAO (the portfolio series'
fee_swap_tao_raofor this one account): TAO fees as charged, alpha fees at the day's closing price. Informational: the fee is already inside the flow (the alpha received or the TAO paid out is net of it), so never add it again. Pool steps without a stake event (claims, registrations, fund swaps) state no fee and are left out. On the open row: today so far, as ofas_of_height, by the same rules (alpha at that block's price); null withfee_unavailable_reasontoo_many_rowswhen the account paid over 200 transaction fees since the last close. Null when a trade's event carries no fee (dTAO trades before runtime spec 256, blocks 4,920,351 to 5,228,683) and on a day whose trade figures aren't available yet. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · on chain: u64
- fee_total_tao_raostring · unit rao (÷1e9) · can be null
fee_tx_tao_rao+fee_tx_alpha_tao_rao+fee_swap_tao_rao, in rao of TAO, as a positive amount paid (the portfolio series'fee_total_tao_raofor this one account; negative only through a refunded alpha fee). Informational: every part is already inside the flows or the stake. Null when any part is. Basis: fair value (the valuation standard's revisionrev5or later,meta.valuation_standard): each subnet's alpha at its per-unit fair value at the day's close (the close price on a deep pool, the price a small reference sale would get on a thin one; flows and fees at the same per-unit value). A pool that moves between depth levels from one close to the next shows as a price effect. Two disclosed departures: a liquidity position's alpha leg stays at the close mark, and a dissolved subnet life's position keeps the prices of its own movements.- Format: whole number, as a string · can be negative
- earned_spot_tao_raostring · unit rao (÷1e9) · can be null
The stake's earnings that day, in rao of TAO (signed): its alpha change minus the account's own flows, at the day's close (growth + income + fee + other). It equals the portfolio series'
stake_earned_tao_raofor the same account and day. Served on closed days; null withearned_unavailable_reasonotherwise (always on the open row). Null when an income credit of the day has no price (not_priced): never a partial sum.- Format: whole number, as a string · can be negative
- earned_usdstring · unit usd · 6 decimals · can be null
earned_spot_tao_raoin USD at the day's close rate (tao_usd), signed, 6 decimal places. Null whenearned_spot_tao_raois null or the day has no close rate (then withearned_unavailable_reasonincomplete_data).- Format: decimal number, as a string · can be negative
- stake_fair_value_tao_raostring · unit rao (÷1e9) · can be null
The stake at fair value, in rao of TAO (the portfolio series'
stake_fair_value_tao_raofor this one account): each held subnet position valued at its pool's fair-value level at the day's close (L1: its spot value;L2: the alpha at the 10-alpha reference-sale price;L3: a measured Level 3 value (each subnet row'sfv_method): the price a 10-alpha sale would get from the pool's reserves (reference_sale; from the TAO reserve alone when the alpha reserve is 0), 0 when the pool holds no TAO (no_tao), or, at an instant with neither reserve during the subnet's dissolution, the dissolution payout (dissolution); floored per position), summed.stake_spot_tao_raois unchanged beside it. Null, never a partial sum, when a held position has no price or level (unpriced,reserves_unknown), and on an older answer also when one is on anL3pool (fv_reasonthin_pool). Levels, by the pool at the day's close:L1(at least 1,000 alpha in the pool's reserve) values alpha at the pool price, so anL1figure is the spot figure;L2(at least 1 alpha in reserve) at the price a 10-alpha sale would get, fees excluded;L3(less than 1 alpha in reserve) at a measured Level 3 value (each subnet row'sfv_method): the price a 10-alpha sale would get from the pool's reserves (reference_sale; from the TAO reserve alone when the alpha reserve is 0), 0 when the pool holds no TAO (no_tao), or, at an instant with neither reserve during the subnet's dissolution, the dissolution payout (dissolution). Root isL1. An older answer (itsfv_level_mixcarriesvalue_l3_or_unpriced_spot_tao_rao, notvalue_l3_tao_rao) givesL3no fair value (thin_pool); a current answer valuesL3and never saysthin_pool.- Format: whole number, as a string · on chain: u64
- fv_level_worststring · can be null
The worst fair-value level (
L1best,L3worst) among the account's stake positions that day (held, moved or credited). Null when there is none, or none has a price. Levels, by the pool at the day's close:L1(at least 1,000 alpha in the pool's reserve) values alpha at the pool price, so anL1figure is the spot figure;L2(at least 1 alpha in reserve) at the price a 10-alpha sale would get, fees excluded;L3(less than 1 alpha in reserve) at a measured Level 3 value (each subnet row'sfv_method): the price a 10-alpha sale would get from the pool's reserves (reference_sale; from the TAO reserve alone when the alpha reserve is 0), 0 when the pool holds no TAO (no_tao), or, at an instant with neither reserve during the subnet's dissolution, the dissolution payout (dissolution). Root isL1. An older answer (itsfv_level_mixcarriesvalue_l3_or_unpriced_spot_tao_rao, notvalue_l3_tao_rao) givesL3no fair value (thin_pool); a current answer valuesL3and never saysthin_pool. New values may be added; show an unknown value as is (or generically).- fv_level_mixobject · can be null
The held positions by fair-value level:
value_l1_tao_rao+value_l2_tao_rao+value_l3_tao_rao=stake_fair_value_tao_raowhenever that is served, andvalue_unpriced_spot_tao_raoholds the unpriced rest at spot. On an older answervalue_l1_tao_rao+value_l2_tao_rao= the fair value andvalue_l3_or_unpriced_spot_tao_raoholds the rest at spot. Null only on an open row over the address cap.6 fields in fv_level_mix
- value_l1_tao_raostring · unit rao (÷1e9)
Positions on an
L1pool, at fair value (= their spot value), in rao of TAO.- Format: whole number, as a string · on chain: u64
- value_l2_tao_raostring · unit rao (÷1e9)
Positions on an
L2pool, at fair value (the alpha at the 10-alpha reference-sale price, floored per position), in rao of TAO.- Format: whole number, as a string · on chain: u64
- value_l3_or_unpriced_spot_tao_raostring · unit rao (÷1e9) · can be null
An older answer's bucket: positions with no fair value there (an
L3pool, or no level), at SPOT, in rao of TAO: the partstake_fair_value_tao_raocannot hold, never added to it. Null on a current answer, which splits it intovalue_l3_tao_raoandvalue_unpriced_spot_tao_rao.- Format: whole number, as a string · on chain: u64
- value_l3_tao_raostring · unit rao (÷1e9) · can be null
Positions on an
L3pool, at fair value (a measured Level 3 value (each subnet row'sfv_method): the price a 10-alpha sale would get from the pool's reserves (reference_sale; from the TAO reserve alone when the alpha reserve is 0), 0 when the pool holds no TAO (no_tao), or, at an instant with neither reserve during the subnet's dissolution, the dissolution payout (dissolution); floored per position), in rao of TAO: part ofstake_fair_value_tao_rao. Null on an older answer (value_l3_or_unpriced_spot_tao_rao).- Format: whole number, as a string · on chain: u64
- value_unpriced_spot_tao_raostring · unit rao (÷1e9) · can be null
Positions with no fair value (missing chain data: no price or no level), at SPOT, in rao of TAO: the part
stake_fair_value_tao_raocannot hold, never added to it; while it is above 0 the fair value is null. Null on an older answer (value_l3_or_unpriced_spot_tao_rao).- Format: whole number, as a string · on chain: u64
- unpriced_countinteger · unit count
Held positions with no price at all (valued in none of the other buckets).
- fv_reasonstring · can be null
Why a fair-value figure is null; null when nothing is withheld for valuation.
unpriced/reserves_unknown: onlystake_fair_value_tao_raois null (missing chain data; on a current answer the only cause,unpriced).too_many_addresses: an open row over the address cap.thin_pool(an older answer only; a current answer valuesL3pools): a stake position is on anL3pool at the day's close (earned_spot_tao_rao,earned_usdandstake_fair_value_tao_raoare null), or the previous close held one (the day's return is not measurable at fair value; the earnings are served). An open vocabulary: clients must accept a value not listed here and show it as it is. New values may be added; treat unknown values as unavailable.
Response headers
10 headers: ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- ETag
Strong validator of this answer. Send it back as
If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.- Cache-Control
One of three classes: settled
public, max-age=3600, stale-while-revalidate=86400(pinned to a block that cannot move), 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.
- ADDRESS_NOT_IN_PLAN_SCOPE
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_ADDRESS
- INVALID_DAY
- INVALID_INTERVAL
- INVALID_RANGE
- NOT_READY
- PAYMENT_REQUIRED
- RANGE_TOO_LARGE
- 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.