Skip to content
TAO$188.12
BTC0.002928
MCap$2.21B
Vol$86.07M

API reference / Portfolio

Daily balance and value series of an account

GET/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 before to_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; 1d is 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_rao on the portfolio series; on an account's series the portfolio series' figure for the same account and day) in USD at that day's tao_usd (the TAO/USD close), 2 decimals, signed. Null when the TAO figure or tao_usd is, and on an open row. Basis: fair value (the valuation standard's revision rev5 or 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's tao_usd (the TAO/USD close), 2 decimals, signed. Null when the TAO figure or tao_usd is, 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's tao_usd (the TAO/USD close), 2 decimals, signed. Null when the TAO figure or tao_usd is, and on an open row. Basis: fair value (the valuation standard's revision rev5 or 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's tao_usd (the TAO/USD close), 2 decimals, signed. Null when the TAO figure or tao_usd is, 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 in total_spot_tao_rao or the balances. Null with accrued_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_reason conversion_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_reason conversion_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_rao keeps 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_reason conversion_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_claimable era (through 2026-08-02), a current answer (its fv_level_mix carries value_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). Inside stake_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_reason conversion_day); the stock, the value, the return and the P&L are served.

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

Why accrued figures are null; null when they are served. Given whenever accrued_claimable_tao_rao is null. not_ready: the accrued figures are not available yet for that period. unpriced: a claimable holding (or a fund holding behind it) has no fair value at the day's close (no price; on an older answer also an L3 pool): the figure is null, never a partial sum. thin_pool (an older answer only; a current answer values L3 pools): the held figures are withheld (a held stake position on an L3 pool at the day's close or the previous close, fv_reason): the price effect, P&L and returns including accrued are null; the value and the stock are served. nav_anchor_missing: the data needed to value a fund at the close is missing (a data gap, not a missing price). lp_fee_unstated: a liquidity position's fees are stated nowhere that day, so the income, P&L and returns including accrued are null. incomplete_data: another value the figure needs is unknown (the previous day's, for example). base_below_dust: the previous close's value including accrued is below 0.001 TAO, so the day's return is null (the TWR skips the day). conversion_day: 2026-08-03, the on-chain conversion of the root claimable into basket units: the day's accrual, claimed, forfeited and claim cost are null; the stock, the value, the return and the P&L are served. day_not_closed: an open row (accrued figures are stated for closed days only). 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.

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) plus accrued_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_accrued returns are measured on; not a balance (total_spot_tao_rao stays held-only). Served whenever the accrued part is, an older answer's thin-pool day (fv_reason thin_pool) included; null when the accrued claimable or the held base is. Basis: fair value (the valuation standard's revision rev5 or 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 of stake_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 revision rev5 or 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_rao less 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 revision rev5 or 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_rao less the root claims booked as income that day, plus accrued_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 in stake_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_reason thin_pool; accrued_unavailable_reason says thin_pool too) 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 that value_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 in stake_price_effect_tao_rao) and of the accrued claimable (at its per-unit fair value), forfeits (also shown in accrued_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_reason thin_pool; accrued_unavailable_reason says thin_pool too) 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 revision rev5 or 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_rao excluded, as in stake_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_reason thin_pool; accrued_unavailable_reason says thin_pool too) 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 revision rev5 or 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_rao in USD at that day's tao_usd, 2 decimals, signed. Null when either is. Basis: fair value (the valuation standard's revision rev5 or 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 and stake_other_tao_rao are not, as in stake_return_ratio. Null when the previous close's value including accrued is below 0.001 TAO (dust), and otherwise as stake_price_effect_incl_accrued_tao_rao. Basis: fair value (the valuation standard's revision rev5 or 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_ratio in USD terms: (1 + stake_return_incl_accrued_ratio) x tao_usd / the previous close's tao_usd - 1, 8 decimals, signed. Null when the TAO return or either rate is. Basis: fair value (the valuation standard's revision rev5 or 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_height on 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_rao in the total (lp_position_basis mark). "0" outside the LP days (2025-07-08 to 2026-01-05) and on the open rows (no position can be open); null with lp_position_spot_unavailable_reason while the mark isn't available yet. Basis: always the close mark (the alpha leg at the close price), whatever meta.valuation_standard says; 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), whatever meta.valuation_standard says; 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), whatever meta.valuation_standard says; 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_unavailable_reasonstring · can be null

Why lp_position_spot_tao_rao (and its two legs) is null: not_ready (the mark isn't available yet: the total uses the cost, else 0 and total_is_lower_bound), unpriced (a pool has no close price). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

lp_position_basisenum · can be null

How the LP positions enter total_spot_tao_rao: mark (lp_position_spot_tao_rao) when available, else cost (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): then total_is_lower_bound is 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_rao valued at a fair-value Level-3 price (no observable pool price), in rao of TAO. RESERVED: null with stake_level3_unavailable_reason not_ready while the data isn't available yet, never 0 for unknown; it then fills with no format change. Basis: always the close price (spot), whatever meta.valuation_standard says.

Format: whole number, as a string · on chain: u64
stake_level3_unavailable_reasonstring · can be null

Why stake_level3_spot_tao_rao is null: not_ready (the data isn't available yet). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

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 with free_burn_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_ready (never a partial sum).

Format: whole number, as a string · on chain: u64
free_burn_unavailable_reasonstring · can be null

Why free_burn_rao is null: not_ready (the closed day's free-flow figures aren't available yet: every closed day of a portfolio window whose closed days are not all available), day_not_closed (every open row, on both series; never a closed one). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

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_rao minus 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 with free_evm_bridge_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_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.value into 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 with free_evm_bridge_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_ready (never a partial sum).

Format: whole number, as a string · on chain: u64
free_evm_bridge_unavailable_reasonstring · can be null

Why free_evm_bridge_in_rao / free_evm_bridge_out_rao is null: not_ready (the closed day's free-flow figures aren't available yet: every closed day of a portfolio window whose closed days are not all available), day_not_closed (every open row, on both series; never a closed one). Only ever beside a null in its own field(s); null whenever they are served. not_ready also means the row's free_transfer_* include the EVM crossings. day_not_closed (the open rows only, on both series): the free-flow group (every free leg, free_transfer_*, the bridge legs and their set splits) counts only at a close and is null there. The bridge's set split (free_evm_bridge_inside_set_in_rao / _out_rao, free_evm_bridge_across_set_in_rao / _out_rao) has its own reason, free_evm_bridge_set_split_unavailable_reason. New values may be added; treat unknown values as unavailable.

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_stake withdrawals. Staking through the EVM precompile is in free_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 with free_stake_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_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_stake deposits and the stake returned on deregistration. Unstaking through the EVM precompile is in free_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 with free_stake_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_ready (never a partial sum).

Format: whole number, as a string · on chain: u64
free_stake_unavailable_reasonstring · can be null

Why free_stake_buy_rao / free_stake_sell_rao is null: not_ready (the closed day's free-flow figures aren't available yet: every closed day of a portfolio window whose closed days are not all available), day_not_closed (every open row, on both series; never a closed one). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

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_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_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_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_ready (never a partial sum).

Format: whole number, as a string · on chain: u64
free_other_unavailable_reasonstring · can be null

Why free_other_in_rao / free_other_out_rao is null: not_ready (the closed day's free-flow figures aren't available yet: every closed day of a portfolio window whose closed days are not all available), day_not_closed (every open row, on both series; never a closed one). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

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

The residual: the day's change in free + reserved (System.Account at the day's last block against the previous day's) minus every leg above, the transfers and fee_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 with free_unexplained_unavailable_reason not_ready on 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 with day_not_closed on 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.totals the covered (closed) days' sum only when every covered day is available, else null with not_ready (never a partial sum).

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

Why free_unexplained_rao is null: not_ready (the closed day's free-flow figures aren't available yet: every closed day of a portfolio window whose closed days are not all available), day_not_closed (every open row, on both series; never a closed one). Only ever beside a null in its own field(s); null whenever they are served. New values may be added; treat unknown values as unavailable.

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 is meta.to_day + 1 (meta.to_day stays the last closed day), and every value on it is read at as_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_ratio and 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, flagged total_is_lower_bound). Basis: always the close price (spot), whatever meta.valuation_standard says.

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. 0 when 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_rao in USD at that day's tao_usd (an amount), 6 decimals. Null when either is null.

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

Why root_spot_tao_rao is null: day_not_closed on the open row (the subnet split is stated at the close only). Null when the root stake is stated. New values may be added; treat unknown values as unavailable.

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 an L3 pool, fv_reason thin_pool), and on an older data version's answer.

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

Why stake_growth_tao_rao is null: too_many_addresses (more addresses than the closing day's cap), emission_pending (today's open row while the emission data trails), incomplete_data (any other missing input: an unpriced subnet holding growth, the live inputs trailing, or the first closed day without a previous close). Null exactly when stake_growth_tao_rao is served. The figures derived from the growth (stake_other_tao_rao, stake_price_effect_tao_rao, stake_pnl_tao_rao and the returns) are null because it is and carry no reason of their own. Null on an older data version's answer. New values may be added; treat unknown values as unavailable.

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_rao is null and total_spot_tao_rao leaves 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_rao null). 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 of as_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 includes lp_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 with not_ready) the total is without it. The LP part is at mark when available (lp_position_basis mark), else at cost (cost), else 0 (total_is_lower_bound true). Basis: always the close price (spot), whatever meta.valuation_standard says.

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_rao and total_spot_usd. Null with lp_position_cost_unavailable_reason.

Format: whole number, as a string · on chain: u64
lp_position_cost_unavailable_reasonstring · can be null

Why lp_position_cost_tao_rao is null: not_ready (the LP positions are not available yet; the total is then without them), deposit_price_unknown (a deposit block has no pool price). Only beside a null cost. Null otherwise. When the cost is not known on an LP-era day, total_is_lower_bound may be true (the positions are missing from the total). New values may be added; treat unknown values as unavailable.

basket_entitlement_unavailable_reasonstring · can be null

Why basket_entitlement_spot_tao_rao is null (the portfolio series' reason for the same account and day): not_ready, unpriced or day_not_closed. The entitlement is "0" when nothing is owed, so a null always carries a reason. New values may be added; treat unknown values as unavailable.

total_is_lower_boundboolean · can be null

True when total_spot_tao_rao is a lower bound: a subnet was unpriced that day (subnets_unpriced > 0; the total omits its positions, and stake_spot_tao_rao is null), or an LP-era day (2025-07-08 to 2026-01-05) whose lp_position_cost_tao_rao is not known (null with its reason): the open liquidity positions at cost are missing from the total. It applies to total_spot_usd and to this API's total_incl_unclaimed_spot_tao_rao / _usd too (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), whatever meta.valuation_standard says.

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 the in_stake era, where the dividends are inside the stake earnings), the root claimable newly accrued in the root_claimable era. 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_rao in USD at that day's tao_usd (an amount), 6 decimals. Null exactly when tao_usd is (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), whatever meta.valuation_standard says.

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 when basket_entitlement_missing is false (none owed); null when it is true or null, and always on the open row (which never carries the entitlement). A lower bound whenever total_is_lower_bound is true (it is computed from that total). Null when either part is null (an unknown unclaimed amount never counts as 0); equal to total_spot_tao_rao when basket_entitlement_spot_tao_rao is 0. 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_rao in USD at that day's tao_usd, the price total_spot_usd uses (6 decimals, half away from zero). Null when either is null; equal to total_spot_usd when basket_entitlement_spot_tao_rao is 0. 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's as_of_height. Null when either is. Basis: always the close price (spot): stake_spot_tao_rao x the day's TAO/USD rate, whatever meta.valuation_standard says; 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_ratio for 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 revision rev5 or 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) x tao_usd / the previous close's tao_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 revision rev5 or 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_standard says: 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.Transfer only: 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's free_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 in free_evm_bridge_in_rao / free_evm_bridge_out_rao instead. 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_reason day_not_closed on 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.Transfer only: 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's free_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 in free_evm_bridge_in_rao / free_evm_bridge_out_rao instead. 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_reason day_not_closed on 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.Transfer only: 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's free_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 in free_evm_bridge_in_rao / free_evm_bridge_out_rao instead. 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_reason day_not_closed on 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_rao for 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 are fee_tx_alpha_tao_rao). A cost of the free balance, outside stake: in no stake figure. On the open row: today so far, as of as_of_height, by the same rules (alpha at that block's price); null with fee_unavailable_reason too_many_rows when 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, its stake_fee_tao_rao negated, for this one account). Negative only when a fee refunded after dispatch exceeded that day's fees. Already inside the stake and stake_return_ratio: never add it again. On the open row: today so far, as of as_of_height, by the same rules (alpha at that block's price); null with fee_unavailable_reason too_many_rows when the account paid over 200 transaction fees since the last close. Null where the portfolio series' stake_fee_tao_rao is null. Basis: fair value (the valuation standard's revision rev5 or 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_rao for 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 of as_of_height, by the same rules (alpha at that block's price); null with fee_unavailable_reason too_many_rows when 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 revision rev5 or 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_rao for 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 revision rev5 or 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_unavailable_reasonstring · can be null

Why the row's fee_total_tao_rao (and its parts) is null, on closed and open rows alike (the portfolio series' fee_unavailable_reason for this one account). Only ever set beside a null fee_total_tao_rao. too_many_rows: the account paid more than 200 transaction fees since the last close (a validator owner's weight upkeep: about 3,000 a day), past the open row's read budget; the closed row serves the day's fees. too_many_addresses: the portfolio series' code for an address set over its open-day cap, kept in the shared list. The four fees are null beside either. fee_not_stated_by_chain: a trade that day carries no fee on chain (dTAO trades before runtime spec 256), so fee_swap_tao_rao is null. incomplete_data: any other null (a part not known: the series' first day, a day that isn't available yet, an unpriced alpha fee, a fee with no leg). fee_legs_mismatch: the day's fee legs don't cover the fee alpha the chain states. Null when the total is served, and on a day whose portfolio figures are missing. New values may be added; treat unknown values as unavailable.

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_rao for the same account and day. Served on closed days; null with earned_unavailable_reason otherwise (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_rao in USD at the day's close rate (tao_usd), signed, 6 decimal places. Null when earned_spot_tao_rao is null or the day has no close rate (then with earned_unavailable_reason incomplete_data).

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

Why earned_spot_tao_rao or earned_usd is null that day; null exactly when both are served. day_not_closed: the open row (earnings are stated for closed days only). no_previous_close: the account's first computed day, which has no previous close to measure from. incomplete_data: a value or price that day is unknown, or the day has no close rate (then earned_spot_tao_rao is served and only earned_usd is null). thin_pool (an older answer only; a current answer values L3 pools): a stake position is on an L3 pool at the day's close (fv_level_worst), so the day's earnings have no fair value. not_priced: an income credit of the day has no price, so the earnings are not stated (never a partial sum). Clients must accept codes not listed here. New values may be added; treat unknown values as unavailable.

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_rao for 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's fv_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_rao is 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 an L3 pool (fv_reason thin_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 an L1 figure 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's fv_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 is L1. An older answer (its fv_level_mix carries value_l3_or_unpriced_spot_tao_rao, not value_l3_tao_rao) gives L3 no fair value (thin_pool); a current answer values L3 and never says thin_pool.

Format: whole number, as a string · on chain: u64
fv_level_worststring · can be null

The worst fair-value level (L1 best, L3 worst) 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 an L1 figure 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's fv_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 is L1. An older answer (its fv_level_mix carries value_l3_or_unpriced_spot_tao_rao, not value_l3_tao_rao) gives L3 no fair value (thin_pool); a current answer values L3 and never says thin_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_rao whenever that is served, and value_unpriced_spot_tao_rao holds the unpriced rest at spot. On an older answer value_l1_tao_rao + value_l2_tao_rao = the fair value and value_l3_or_unpriced_spot_tao_rao holds 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 L1 pool, 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 L2 pool, 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 L3 pool, or no level), at SPOT, in rao of TAO: the part stake_fair_value_tao_rao cannot hold, never added to it. Null on a current answer, which splits it into value_l3_tao_rao and value_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 L3 pool, at fair value (a measured Level 3 value (each subnet row's fv_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 of stake_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_rao cannot 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: only stake_fair_value_tao_rao is 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 values L3 pools): a stake position is on an L3 pool at the day's close (earned_spot_tao_rao, earned_usd and stake_fair_value_tao_rao are 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), slow public, max-age=300, stale-while-revalidate=600 (state that moves in minutes or days) or tip public, max-age=6, stale-while-revalidate=12 (follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Never immutable. no-store on an earlier answer served because the data source failed (X-BTAI-Stale).

CDN-Cache-Control

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

X-BTAI-Stale

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

X-BTAI-Stale-As-Of

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

RateLimit-Policy

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

RateLimit

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

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

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

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

Error codes

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

From the API's published specification, version 1.165.0.