Skip to main content
API referenceAccounts

Accounts

Every Accounts endpoint in the metagraphed API, with its method and path.

Last updated

41 endpoints.

  • Account Axon RemovalsGET /api/v1/accounts/{ss58}/axon-removals
    Fetch one account's axon-removal footprint per subnet over a recent window (7d/30d/90d): each subnet's AxonInfoRemoved count with the first and last removal timestamps, plus account totals, an HHI concentration of where its teardown activity is focused, and the dominant subnet — read from the account_events AxonInfoRemoved stream, which the runtime has never populated; an empty footprint is marked degraded rather than published as a measured zero.
  • Account BalanceGET /api/v1/accounts/{ss58}/balance
    Fetch the live TAO balance (free + reserved, in TAO) for one account, queried from the finney RPC at request time with 60s KV cache.
  • Account Balance By NetworkGET /api/v1/{network}/accounts/{ss58}/balance
    Network-scoped form of /api/v1/accounts/{ss58}/balance — prefix the route with a network to choose which chain answers it.
  • Account ChildrenGET /api/v1/accounts/{ss58}/children
    Fetch the live child-hotkey delegation graph for one account (#6723, part of the child-hotkey delegation epic #6721) — every child hotkey this account currently delegates stake-weight to, per subnet, queried from the chain's own ChildKeys storage map at request time with 120s KV cache.
  • Account Children By NetworkGET /api/v1/{network}/accounts/{ss58}/children
    Network-scoped form of /api/v1/accounts/{ss58}/children — prefix the route with a network to choose which chain answers it.
  • Account CounterpartiesGET /api/v1/accounts/{ss58}/counterparties
    Fetch the per-counterparty fund-flow rollup for one account — or, with ?counterparty=<ss58>, pair-level native-TAO transfer evidence for one relationship — computed live from the account_events store.
  • Account DeregistrationsGET /api/v1/accounts/{ss58}/deregistrations
    Fetch one account's neuron-deregistration footprint per subnet over a recent window (7d/30d/90d): each subnet's NeuronDeregistered eviction count with the first and last eviction timestamps, plus account totals, an HHI concentration of where its deregistration activity is focused, and the dominant subnet — DERIVED from UID reuse (the slots where this account was the PREVIOUS holder); NeuronDeregistered has never been emitted by the runtime, the payload's derivation block states the lower bound, and degraded marks an answer nothing derived.
  • Account EntitiesGET /api/v1/accounts/{ss58}/entities
    Fetch one address's community-contributed entity labels plus every subnet-ownership tie it has via the chain_events SubnetOwnerChanged stream (#6737-#6740) — either side of an automatic conviction-contest transfer.
  • Account EventsGET /api/v1/accounts/{ss58}/events
    Fetch the paginated first-party chain-event history for one account (hotkey or coldkey), newest first.
  • Account ExtrinsicsGET /api/v1/accounts/{ss58}/extrinsics
    Fetch the extrinsics this account signed (matched by signer), newest first, computed live from the extrinsics tier.
  • Account HistoryGET /api/v1/accounts/{ss58}/history
    Fetch the durable per-day activity series for one account, newest day first, from the hotkey-keyed account_events_daily rollup (#1854).
  • Account Holder DirectoryGET /api/v1/accounts/directory
    Fetch the compact account holder directory used by the website: top stake, emission and subnet-reach rankings derived from one complete neuron-snapshot aggregation.
  • Account IdentityGET /api/v1/accounts/{ss58}/identity
    Fetch the latest-only personal chain identity for one account (epic #4301/5.4), computed live from the account_identity tier.
  • Account Identity HistoryGET /api/v1/accounts/{ss58}/identity-history
    Fetch the append-only diff-tracking timeline for one account's personal chain identity (epic #4301/5.2): each entry is a snapshot recorded when any tracked field changed.
  • Account ParentsGET /api/v1/accounts/{ss58}/parents
    Fetch the live parent-hotkey delegation graph for one account (#6723, part of epic #6721) — every hotkey currently delegating stake-weight to this account, per subnet, queried from the chain's own ParentKeys storage map at request time with 120s KV cache.
  • Account Parents By NetworkGET /api/v1/{network}/accounts/{ss58}/parents
    Network-scoped form of /api/v1/accounts/{ss58}/parents — prefix the route with a network to choose which chain answers it.
  • Account PortfolioGET /api/v1/accounts/{ss58}/portfolio
    Fetch a wallet's cross-subnet neuron portfolio: each position's economics (stake, emission, rank, trust, incentive, dividends, role) and yield, plus aggregates (totals, subnet/validator counts, overall return, stake concentration).
  • Account PositionsGET /api/v1/accounts/{ss58}/positions
    Fetch this account's reconstructed nominator-side positions: what it holds delegated across every hotkey/subnet, distinct from /portfolio's hotkey-scoped view.
  • Account PrometheusGET /api/v1/accounts/{ss58}/prometheus
    Fetch one account's Prometheus-endpoint serving footprint per subnet over a recent window (7d/30d/90d): each subnet's PrometheusServed announcement count with the first and last announcement timestamps, plus account totals, an HHI concentration of where its telemetry activity is focused, and the dominant subnet — read from the account_events PrometheusServed stream.
  • Account RegistrationsGET /api/v1/accounts/{ss58}/registrations
    Fetch one account's neuron-registration footprint per subnet over a recent window (7d/30d/90d): each subnet's NeuronRegistered count with the first and last registration timestamps, plus account totals, an HHI concentration of where its registration activity is focused, and the dominant subnet — summed live from the account_events store.
  • Account Root ClaimGET /api/v1/accounts/{ss58}/root-claim
    Read deprecated per-subnet Root-claim state with explicit runtime compatibility.
  • Account Root Claim By NetworkGET /api/v1/{network}/accounts/{ss58}/root-claim
    Network-scoped form of /api/v1/accounts/{ss58}/root-claim — prefix the route with a network to choose which chain answers it.
  • Account ServingGET /api/v1/accounts/{ss58}/serving
    Fetch one account's axon-serving footprint per subnet over a recent window (7d/30d/90d): each subnet's AxonServed announcement count with the first and last announcement timestamps, plus account totals, an HHI concentration of where its serving activity is focused, and the dominant subnet — summed live from the account_events store.
  • Account Stake FlowGET /api/v1/accounts/{ss58}/stake-flow
    Fetch one account's StakeAdded vs StakeRemoved flow per subnet over a recent window (7d/30d/90d): per-subnet net and gross flow with a direction label (accumulating/exiting/churning/idle), plus account totals, an HHI concentration of where the flow is focused, and the dominant subnet — summed live from the account_events store.
  • Account Stake MovesGET /api/v1/accounts/{ss58}/stake-moves
    Fetch one account's stake-movement (re-delegation) footprint per subnet over a recent window (7d/30d/90d): each subnet's StakeMoved count with the first and last movement timestamps and the alpha price on the day of the most recent move (from the daily subnet_snapshots rollup), plus account totals, an HHI concentration of where its re-delegation churn is focused, and the dominant subnet — summed live from the account_events store.
  • Account Subnet Position HistoryGET /api/v1/accounts/{ss58}/subnets/{netuid}/history
    Fetch one wallet's position on one subnet over time (the 'Alpha Holdings chart'): one point per snapshot_date with the position's economics (stake, emission, rank, trust, incentive, dividends, coldkey, role) and yield, computed live from the account_position_daily rollup tier.
  • Account SubnetsGET /api/v1/accounts/{ss58}/subnets
    Fetch the subnets where an account's hotkey is currently registered (its cross-subnet footprint), computed live from the neurons store.
  • Account SummaryGET /api/v1/accounts/{ss58}
    Fetch a cross-subnet activity summary for one account (hotkey or coldkey): chain-event aggregates joined to its current subnet registrations + stake.
  • Account TransfersGET /api/v1/accounts/{ss58}/transfers
    Fetch the native-TAO Balances.Transfer feed for one account, newest first, computed live from the account_events store.
  • Account Weight SettersGET /api/v1/accounts/{ss58}/weight-setters
    Fetch one account's (validator's) weight-setting footprint per subnet over a recent window (7d/30d): each subnet's WeightsSet count with the first and last set timestamps, plus account totals, an HHI concentration of where its weight-setting activity is focused, and the dominant subnet — summed live from the account_events store.
  • Accounts ListGET /api/v1/accounts
    Fetch the site-wide accounts leaderboard: every currently-registered hotkey (miners included, not just validator_permit=1 ones) grouped across all current subnet memberships, with cross-subnet stake/emission totals, stake dominance, a validator/miner UID breakdown, and top membership rows.
  • Evm Address MappingGET /api/v1/evm/address/{h160}
    Fetch the live H160 -> SS58 address mapping for one EVM address (#6725/#6728), via the AddressMapping EVM precompile's addressMapping(address), queried from the finney RPC at request time with 1h KV cache.
  • Evm Address Mapping By NetworkGET /api/v1/{network}/evm/address/{h160}
    Network-scoped form of /api/v1/evm/address/{h160} — prefix the route with a network to choose which chain answers it.
  • Network ParametersGET /api/v1/network/parameters
    Fetch live global Subtensor protocol/governance parameters (#6343) — TaoWeight, StakeThreshold, PendingChildKeyCooldown — queried from the finney RPC at request time with 300s KV cache.
  • Network Parameters By NetworkGET /api/v1/{network}/network/parameters
    Network-scoped form of /api/v1/network/parameters — prefix the route with a network to choose which chain answers it.
  • RandomnessGET /api/v1/network/randomness
    Fetch the live drand randomness-beacon status (#6730/#6731) — LastStoredRound, OldestStoredRound — queried from the finney RPC at request time with 30s KV cache.
  • Randomness By NetworkGET /api/v1/{network}/network/randomness
    Network-scoped form of /api/v1/network/randomness — prefix the route with a network to choose which chain answers it.
  • Sudo KeyGET /api/v1/sudo/key
    Fetch the current Sudo::Key holder, queried from the finney RPC at request time with 1h KV cache (re-scoped from the original Senate/Council membership framing — subtensor has no such pallet, #4310).
  • Sudo Key By NetworkGET /api/v1/{network}/sudo/key
    Network-scoped form of /api/v1/sudo/key — prefix the route with a network to choose which chain answers it.
  • TAO UsdGET /api/v1/network/tao-usd
    Fetch the TAO/USD index.
  • Top HoldersGET /api/v1/accounts/top-holders
    Fetch the balance-based top-holder leaderboard: every account (coldkey) with a nonzero free balance and/or delegated stake position, with free/delegated/total TAO columns matching the taostats-style Account/Free/Delegated/Total benchmark /api/v1/accounts explicitly cannot derive.