metagraph.sh

Call this ONLY when you have looked through the available tools and none of them can do what you need.

Full-text search across Bittensor subnets by name, slug, capability, or keyword.

Enumerate the full Bittensor subnet registry, paginated.

Find Bittensor subnets that expose callable services (APIs, OpenAPI schemas, SSE streams) matching a capability or category.

Fetch the composed overview for one subnet by netuid: identity, completeness, curated surfaces, health summary, gaps, and counts.

Fetch one subnet's raw per-subnet record by netuid: chain-native structure, live economics, candidate surfaces, endpoints, gaps, and verified surfaces -- the underlying record get_subnet's composed overview is assembled from.

Fan out to five of a subnet's live views in a single round trip: hyperparameters, stake/emission concentration, reward-distribution performance, the top validators by stake (default 10, cap with top_validators_limit), and the most recent chain events (default 10, cap with recent_events_limit).

Fetch the live global operational health rollup: global surface counts by status (ok/degraded/failed/unknown) and per-subnet operational status from the ~15-minute health prober (KV health:current → Postgres surface_status).

Fetch a compact daily operational health snapshot for one UTC date: per-surface status, latency, and summary incident counts from the archived health/history tier.

Fetch live operational health for one subnet's surfaces (probed every ~15 minutes): per-surface status, latency, and last-ok timestamps.

Fetch one subnet's 7d/30d uptime + latency trend per operational surface, aggregated from the live health-probe history (probed every ~15 minutes).

Fetch the compact all-subnet 7d/30d daily uptime + latency trend matrix aggregated from the live health-probe history (probed every ~15 minutes).

Fetch one subnet's request-latency percentiles per operational surface over a 7d or 30d window, from the live health-probe history: p50/p95/p99 plus avg/min/max latency in ms and the healthy-sample count behind them.

Fetch one subnet's per-surface SLA and reconstructed downtime incidents over a 7d or 30d window, from the live health-probe history: per operational surface the sample count, uptime ratio, incident count, total downtime (ms), and each incident's start/end, duration, and failed-sample count (consecutive probe failures collapsed into one incident).

Fetch one subnet's live economics: validator and miner counts, registration cost and whether registration is open, open slots and a miner-readiness signal, total and max stake, alpha price, emission share, and pool reserves.

Estimate a stake or unstake against one subnet's AMM pool: expected alpha/TAO out, spot and effective price, and price impact, computed with the chain's own constant-product swap formula against the subnet's live pool reserves (the same economics tier get_subnet_economics reads).

Answer what it costs to become a validator on one subnet and whether a permit there actually earns.

Answer whether validating on one subnet is getting cheaper or more expensive over time.

Answer 'across all subnets, where is it cheapest to become an EARNING validator'.

Produce a clearly-labeled, human-readable PREVIEW of what a hypothetical stake or unstake against one subnet would look like: the estimated resulting amount out, the effective vs spot price, and the estimated price-impact/slippage -- computed from the same live AMM pool economics get_subnet_stake_quote reads (direction stake spends amount TAO for alpha; unstake spends amount alpha for TAO; root netuid 0 is 1:1).

Fetch the live network-wide economics scorecard: per-subnet validator and miner counts, registration cost and whether registration is open, open slots, stake, alpha price, emission share, and summary totals.

Fetch one subnet's week-over-week trajectory from the daily snapshots: completeness, surface and endpoint counts, validator and miner counts, total stake, alpha price, and emission share over time, plus 7d/30d deltas.

Fetch the network-wide economics time series aggregated per UTC day across all subnets: total stake, stake-weighted and median alpha price, total validator and miner counts, and mean emission share.

Fetch the order in which the chain would deregister subnets to make room for a new registration -- 'how close is this subnet to being pruned', answered with the pallet's own rule.

Fetch the v440 emission pipeline decomposed per subnet at the block the economics capture was pinned to: stage 1's price share (the published `emission_share`), MinerBurned, the post-burn weighted share, the post-Hill-gate share, SubnetEmissionEnabled, the final share of block emission actually received, the gate's give-or-take (`gate_delta`), `distance_to_bar`, and the TAO split -- `tao_in_emission` (pool liquidity injection) vs `excess_tao` (chain buys), their `tao_total`, and `liquidity_fraction`.

Fetch one subnet's live stake and emission decentralization scorecard: Gini, HHI, Nakamoto coefficient, top-percentile shares, and entropy over per-UID, per-entity (coldkey-collapsed), and validator-only distributions.

Fetch one subnet's live reward-distribution scorecard: the concentration (Gini, HHI, Nakamoto coefficient, top-percentile shares, entropy) of the actual rewards — incentive across all neurons and dividends across the validators — plus the p10–p90 spread of the 0–1 trust, consensus, and validator_trust scores.

Fetch one subnet's live idle-stake scorecard: stake delegated to a hotkey currently earning zero dividends.

Fetch the network-wide stake and emission decentralization scorecard: Gini, HHI, Nakamoto coefficient, top-percentile shares, and entropy over per-UID, per-entity (coldkeys collapsed ACROSS subnets into the true network control distribution — one operator running validators in ten subnets counts once), and validator-only distributions, plus the subnet_count the snapshot spans.

Fetch EVERY subnet ranked by how widely one lens of its distribution is SPREAD — the screening question a prospective miner actually asks, in one call instead of 129 to get_subnet_concentration.

Fetch the network-wide reward-distribution scorecard aggregated across ALL subnets' neurons: the concentration (Gini, HHI, Nakamoto coefficient, top-percentile shares, entropy) of the actual rewards — incentive across all neurons and dividends across validators — plus the p10–p90 spread of the 0–1 trust, consensus, and validator_trust scores, and the subnet_count the snapshot spans.

Fetch the network-wide idle-stake rollup: every subnet's own idle-stake scorecard (stake delegated to a currently-zero-dividends hotkey) ranked by idle_stake_tao descending, plus the network total.

Fetch the network-wide recent subnet-identity-change feed aggregated across ALL subnets (newest first): the most-recent SubnetIdentitiesV3 changes, each carrying the netuid it belongs to plus the same tracked identity fields (name, symbol, description, links, hash) as the per-subnet identity-history, capped to `limit` (default 50, max 200) and reporting the distinct subnet_count the feed spans.

Fetch the network-wide emission-yield scorecard aggregated across every NON-ROOT subnet's neurons (root/netuid 0 is excluded: its stake is TAO, not a subnet alpha token, so including it would mix denominations): the aggregate network return (total emission / total stake), the same split by validator vs miner role, and the count/mean/median/min/max plus p10–p90 spread of the per-neuron emission/stake return, and the subnet_count the snapshot spans.

Fetch the network-wide validator-set turnover leaderboard across ALL subnets between the window's boundary neuron_daily snapshots (7d, 30d, or 90d; default 30d): each subnet ranked by gross validator churn (validators entered + exited) with Jaccard retention and a 0–100 stability score, a network rollup over the union validator set, and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet stability.

Fetch the network-wide cross-subnet capital-flow leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by net TAO flow (StakeAdded minus StakeRemoved) with staked/unstaked/gross totals, stake/unstake event counts, and an inflow/outflow/balanced direction label, plus a network rollup (gaining/losing/flat subnet counts) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet net flow, summed live from the account_events stream.

Fetch the network-wide rolling 24h buy/sell alpha-volume leaderboard: every subnet that had StakeAdded (buy) or StakeRemoved (sell) volume in the last 24h ranked by total_volume_tao, each subnet carrying the same buy/sell/total volume + sentiment scorecard as get_subnet_volume (vol_mcap_ratio always null here — no per-subnet market-cap input in scope at the network level), plus a network rollup (with its own net/gross sentiment reading) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet total volume, summed live from the account_events stream.

Fetch the network-wide validator weight-setting leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by WeightsSet events with its distinct-setter count and sets-per-setter update intensity, plus a network rollup (distinct setters, total weight sets, sets per setter) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch the network-wide weight-setter leaderboard over a 7d or 30d window (default 7d): the individual validators driving consensus across every subnet, each with its total WeightsSet count (summed across every subnet it operates on), its share of the network total, and its first/last set times, ranked by activity and capped by limit (1-100, default 20).

Fetch the network-wide stake-movement (re-delegation) leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by StakeMoved events with its distinct-mover (coldkey) count and movements-per-mover intensity, plus a network rollup (distinct movers, total movements, movements per mover) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch the network-wide stake-transfer leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by StakeTransferred events with its distinct-sender (origin coldkey) count and transfers-per-sender intensity, plus a network rollup (distinct senders, total transfers, transfers per sender) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch the network-wide axon-teardown leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by AxonInfoRemoved events with its distinct-remover (hotkey) count and removals-per-remover intensity, plus a network rollup (distinct removers, total removals, removals per remover) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch the network-wide axon-endpoint serving leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by AxonServed events with its distinct-server (hotkey) count and announcements-per-server intensity, plus a network rollup (distinct servers, total announcements, announcements per server) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch the network-wide Prometheus-endpoint serving leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by PrometheusServed events with its distinct-exporter (hotkey) count and announcements-per-exporter intensity, plus a network rollup (distinct exporters, total announcements, announcements per exporter) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Block-production analytics over recent blocks: inter-block time distribution, extrinsic/event throughput, block-author decentralization (concentration over each author's block count, distinct from get_chain_signers), and the spec-version spread.

Fetch one subnet's per-day stake and emission concentration trend (Gini, Nakamoto coefficient, top-10% share) from the neuron_daily rollup over the requested window (7d, 30d, or 90d).

Fetch one subnet's validator-set and registration churn between the start and end neuron_daily snapshots in the requested window (7d, 30d, 90d, 1y, or all; default 30d): validators entered/exited, Jaccard retention for validators and neurons, UID deregistrations, and a 0–100 stability score.

Fetch one subnet's per-UID emission yield (emission_tao over stake_tao) from the current metagraph snapshot: each UID ranked by return rate with stake, emission, role, and an above/below/at-median label, plus subnet aggregate yield and mean/p25/median/p75/p90 percentiles over UIDs with stake.

Fetch the per-day emission-yield distribution trend for one subnet over a 7d, 30d, or 90d window (default 30d): each day's subnet-wide return (total emission over total stake) plus the mean, median, p25, p75, and p90 of the per-UID emission-per-stake yields from the neuron_daily rollup.

Fetch the per-day split of one subnet's emission by recipient class over a 7d, 30d, or 90d window (default 30d): how much went to the owner, to validators, and to miners, plus how many validator and miner UIDs actually earned anything that day.

Measure whether a subnet's registered miners actually EARN, over a 7d, 30d or 90d window (default 30d).

Read what one subnet SAYS it takes to run a miner or a validator there, beside what the chain EXACTLY charges to enter and what miners there actually earned.

Read what one subnet's own published SOURCE CODE declares it allocates to a treasury, against what the chain shows.

Measure how much of one subnet's emission reaches its OWNER, per day over a 7d, 30d or 90d window (default 30d).

Fetch one subnet's net stake flow over the requested window (7d, 30d, or 90d; default 30d): TAO staked (StakeAdded) vs unstaked (StakeRemoved), the net capital flow, and event counts, summed live from the account_events stream.

Fetch a windowed account-event summary for one subnet over the requested window (7d, 30d, or 90d; default 30d): per-event_kind counts (events, distinct hotkeys/coldkeys, summed TAO and alpha amounts, block/observation bounds) plus overall totals, followed by a recent-events tail of the newest events.

Fetch one subnet's validator weight-setting activity over a 7d or 30d window (default 7d): the distinct weight-setting validators, WeightsSet event count, and average updates per validator, computed live from the account_events WeightsSet stream.

Fetch the per-subnet weight-setter leaderboard over a 7d or 30d window (default 7d): the individual validators behind /weights ranked by activity, each with its WeightsSet count, its share of the subnet's total weight-setting, and its first/last set times, computed live from the account_events WeightsSet stream.

Fetch neuron-registration activity for one subnet over a 7d or 30d window (default 7d): the NeuronRegistered count, the number of distinct registrant hotkeys, and the registrations-per-registrant intensity, computed live from the account_events NeuronRegistered stream.

Fetch one subnet's stake-movement activity over a 7d or 30d window (default 7d): the StakeMoved event count, the number of distinct movers (coldkeys), and the movements-per-mover intensity, computed live from the account_events StakeMoved stream.

Fetch one subnet's stake-transfer activity over a 7d or 30d window (default 7d): the StakeTransferred event count, the number of distinct senders (coldkeys), and the transfers-per-sender intensity, computed live from the account_events StakeTransferred stream.

Fetch one subnet's axon-removal activity over a 7d or 30d window (default 7d): the distinct removers (hotkeys), AxonInfoRemoved event count, and average removals per remover, computed live from the account_events AxonInfoRemoved stream.

Fetch one subnet's axon-endpoint serving activity over a 7d or 30d window (default 7d): the distinct servers (hotkeys), AxonServed event count, and average announcements per server, computed live from the account_events AxonServed stream.

Fetch one subnet's Prometheus-endpoint serving activity over a 7d or 30d window (default 7d): the distinct exporters (hotkeys), PrometheusServed event count, and average announcements per exporter, computed live from the account_events PrometheusServed stream.

Fetch neuron-deregistration activity for one subnet over a 7d or 30d window (default 7d): the distinct deregistered hotkeys, the NeuronDeregistered event count, and the average deregistrations per hotkey, computed live from the account_events NeuronDeregistered stream.

Fetch the per-day reward-flow and trust trend for one subnet over a 7d, 30d, or 90d window (default 30d): daily incentive/dividends Gini, Nakamoto coefficient, top-10% share, plus mean/median trust, consensus, and validator_trust scores from the neuron_daily rollup.

Fetch the cross-subnet movers leaderboard over the requested window (7d, 30d, or 90d; default 30d): every subnet ranked by its change in stake, emission, or validator count between the window's start and end neuron_daily snapshots.

Fetch one subnet's long-term daily uptime history for its operational surfaces from the live surface_uptime_daily rollup.

Fetch the live registry leaderboards that combine probe health with registry completeness and the economics tier: healthiest, fastest-rpc, most-complete, most-enriched, fastest-growing, plus the economic opportunity boards (open-slots, cheapest-registration, highest-emission, validator-headroom, biggest-alpha-gain-1d, biggest-alpha-gain-7d).

Fetch the DefiLlama-style aggregation layer over the existing 14-tag domain/capability taxonomy already exposed read-only via ?

Fetch the public-safe subnet profile index: completeness scores, surface and interface counts, curation level, review state, and confidence for every registered subnet.

Fetch the public-safe profile detail for one subnet by netuid: completeness score, curation and review metadata, native identity signals, surface counts, and contributor-facing enrichment context.

Place several subnets side by side across registry structure, economics, and live probe health in one call.

Fetch the cross-subnet incident ledger: surfaces that had consecutive probe failures grouped into downtime incidents over the requested window (7d or 30d).

Fetch one subnet's per-UID metagraph snapshot: every neuron with its hot and cold keys, stake, rank, trust, consensus, incentive, dividends, emission, validator permit, immunity, and axon, ordered by UID.

List one subnet's permit-holding validators, ranked by stake (descending): hot and cold keys, stake, validator trust, consensus, dividends, emission, and axon.

Fetch the network-wide validator/operator leaderboard: validator-permit identities grouped by hotkey across all current subnet memberships, with trust metrics, cross-subnet stake/emission totals, stake dominance, and top membership rows.

Fetch a single validator identity's validator_permit rows aggregated across every subnet it operates in: coldkey, cross-subnet stake/emission totals, avg/max validator trust, and the full per-subnet membership list.

Place several validators side by side for a stake/delegate decision: for each hotkey, its take rate, estimated APY, nominator count, and on-chain (coldkey) identity, plus the cross-subnet stake/emission/trust aggregates that give those numbers context -- the same per-validator detail list_global_validators / get_validator_detail expose, projected to the fields that drive a delegate choice.

Fetch a webhook change-feed subscription's public status by id: its url, filters, active flag, created_at, and recent delivery health.

Fetch a chain alert trigger's full configuration and status by id.

Fetch the nominators (stakers) of one validator across every subnet it operates in.

Fetch one validator's cross-subnet staked-over-time history: one point per day, summed across every subnet it validates in, plus a rewards-per-1000-TAO rate.

Fetch a single neuron in one subnet, named by EITHER its `uid` (slot number) OR its `hotkey` (SS58) — give one, not both.

Fetch one subnet's per-day history from the neuron_daily rollup: neuron count, validator count, total stake (TAO) and total emission (TAO) per snapshot_date, newest first.

Fetch the append-only on-chain identity timeline for one subnet (#1647): each entry is a SubnetIdentitiesV3 snapshot recorded when any tracked field changed (name, symbol, description, repo, website, discord, logo).

Fetch a single neuron's per-day time series in one subnet by its UID, from the neuron_daily rollup: stake, rank, trust, consensus, incentive, dividends, emission, validator permit, axon, and take per snapshot_date, newest first.

Fetch the paginated first-party chain-event stream for one subnet by its netuid, newest first: each event's kind, block, UID, hot/cold keys, amount, and timestamp.

Fetch one subnet's current on-chain hyperparameters (tempo, weight limits, activity cutoff, immunity period, registration allowed, and the rest of the SubtensorModule hyperparameter set).

Fetch the append-only hyperparameter-change timeline for one subnet: one entry per detected diff, newest first.

Fetch one subnet's append-only registration/deregistration timeline, newest first.

Fetch the network-wide subnet registration/deregistration feed, newest first.

Fetch one subnet's rolling 24h buy (StakeAdded) vs sell (StakeRemoved) alpha volume, unsigned (buy + sell, never netted) — a canonical market-depth figure, not a windowed analytics view.

Fetch open/high/low/close/volume candles for one subnet's alpha price, bucketed by interval (1h or 1d, default 1h) from the same StakeAdded/StakeRemoved account_events stream get_subnet_volume reads — each row is one executed trade, price = amount_tao / alpha_amount.

Fetch every automatic ownership transfer one subnet has undergone (#6637, part of the conviction/ownership-contest tracker epic #4302), decoded from the chain_events SubnetOwnerChanged stream.

Fetch the live per-subnet conviction leaderboard (#6638, part of the conviction/ownership-contest tracker epic #4302) — who currently holds the most rolled conviction, i.

Fetch one subnet's declared wallets: the chain-derived owner keys, plus any treasury, burn, payment-collector or multisig address the team has published and somebody has evidenced.

Fetch one subnet's owner-cut accrual and its disposition.

Fetch one subnet's external revenue against the TAO the network emits to it: the measured tao_total denominator (SubnetTaoInEmission + SubnetExcessTao) with its alpha-priced and 18% owner-take alternates, the observed revenue, and the two ratios -- coverage_ratio (revenue/emission) and subsidy_multiple (emission/revenue).

Fetch every subnet's revenue coverage in one response -- the cross-subnet companion to get_subnet_revenue.

Fetch the live cumulative TAO recycled for registration on one subnet, queried directly from the chain's RAORecycledForRegistration storage at request time (not a rollup).

Fetch the live current registration/burn cost for one subnet (#6321) -- the dynamic price between the static min_burn_tao/max_burn_tao bounds, queried directly from the chain's Burn storage at request time (not a rollup).

Fetch how one subnet's registration/burn cost has MOVED (#9402) -- the live routes answer what it costs now, this answers whether it is getting more or less expensive, which is what decides where and WHEN to register.

Fetch the USD price of one TAO (#9609) with the derivation behind it, plus the recent series.

Fetch WHEN one subnet's public surfaces were added, changed or removed, and in which commit (#9612).

Fetch EVERY recorded change to the emission gate (#9615) -- its governance parameters, the per-subnet emission switches, and the dormant TAO-flow path, in one chronological feed.

Fetch EVERY subnet ranked by how concentrated its alpha OWNERSHIP is (#9607) -- per subnet the distinct holder count, measured alpha total, top1/top5/top10/top20 shares and the largest holder's coldkey (an ss58 address).

Fetch WHY registry surfaces fail and whether the mix is changing (#9622) -- the classification breakdown (live, redirected, transient, rate-limited, timeout, dead, content-mismatch, unsupported, auth-required) over a window, plus a per-day series.

Fetch HOW LONG AFTER A BLOCK IS PRODUCED it becomes queryable here (#9620) -- the write-latency distribution (min/p50/p95/p99/max/mean, in milliseconds) over the retained block window, plus how far behind the lane is right now.

Fetch WHETHER THE NETWORK IS GETTING MORE CONCENTRATED (#9628) -- the network-wide concentration card as a per-day series, each point carrying the same five lenses the live card does (stake, emission, entity_stake, entity_emission, validator_stake, each with holders/gini/hhi/nakamoto_coefficient/top-K shares/entropy) plus uids_per_entity.

Fetch ONE SUBNET'S emission-pipeline decomposition OVER TIME (#9625) -- emission share, the TAO split (pool-liquidity injection vs chain buys), alpha in/out emission, miner burned fraction, whether emission is enabled -- one point per day, each pinned to the block it was captured at.

Fetch ONE SUBNET'S position in the chain's pruning order OVER TIME (#10296).

Fetch the ADDRESSES THE SWEEP FOUND AND A HUMAN HAS NOT YET JUDGED (#11227).

Fetch WHO OWNS one subnet's alpha (#9557) -- the top coldkeys by alpha held on that netuid, each with its share of the subnet total and how many hotkeys it holds through, plus whole-subnet aggregates (distinct holder count, total measured alpha, top5/top10/top20 concentration).

Fetch EVERY subnet's live registration/burn cost in one call, ranked cheapest-first (#9399) -- the cross-subnet companion to get_subnet_burn, which answers the same question one subnet at a time.

Fetch every crowdloan the chain currently holds a record for (#8696, part of the subnet-leasing/crowdloan-tracking epic #6717), decoded from the Crowdloan pallet's storage at request time (not a rollup).

Fetch one crowdloan by id (#8696), decoded from the Crowdloan pallet's storage at request time.

Fetch the live subnet-lease state (#6719, part of the subnet-leasing/crowdloan-tracking epic #6717) -- whether a subnet is currently under a lease (via a crowdfunded, time-boxed primary market for new subnets) and, if so, its terms (beneficiary, coldkey, hotkey, emissions_share_percent, end_block, cost_tao) and accumulated-but-undistributed alpha dividends, queried directly from the chain's SubnetUidToLeaseId/SubnetLeases/AccumulatedLeaseDividends storage at request time (not a rollup).

Fetch every SubnetLeaseCreated/SubnetLeaseTerminated event one subnet has had (#6719, part of the subnet-leasing/crowdloan-tracking epic #6717), decoded from the account_events stream.

Fetch a cross-subnet activity summary for one account by its SS58 address (a hotkey OR coldkey): total chain-event count, the subnets it has touched, first/last block and timestamp seen, a per-kind event breakdown, where its hotkey is currently registered (with stake and validator permit), its bounded recent signing activity, and its 10 most recent events.

Fetch one coldkey's community-contributed entity labels (exchange/foundation/operator/other) plus every subnet-ownership tie it has via the chain_events SubnetOwnerChanged stream (either side of an automatic conviction-contest transfer).

Fetch the live native-TAO balance (free + reserved, in TAO) for one account by its SS58 address, queried from the finney RPC at request time with a 60s KV cache.

Fetch the live root-claim current state for one Finney ss58 account (#7229): RootClaimType setting, per-hotkey RootClaimable rates, RootClaimed cumulative watermarks, and RootClaimableThreshold — queried from the finney RPC at request time with a 120s KV cache.

Fetch every child hotkey one account currently delegates stake-weight to, per subnet, with the proportion charged (#6723, part of the child-hotkey delegation epic #6721) -- queried directly from the chain's ChildKeys storage at request time (not a rollup).

Fetch every hotkey currently delegating stake-weight to one account, per subnet (#6723, part of epic #6721) -- queried directly from the chain's ParentKeys storage at request time (not a rollup).

Fetch the paginated first-party chain-event history for one account by its SS58 address (hotkey OR coldkey), newest first: each event's kind, block, Subnet, UID, amount, and timestamp.

List the subnets where one account's hotkey is currently registered (by its SS58 address): netuid, UID, stake, validator permit, and active flag per subnet — the live cross-subnet footprint of where a wallet mines and validates right now.

A wallet's cross-subnet neuron portfolio (by SS58 hotkey): each position's economics (stake, emission, rank, trust, incentive, dividends, role) and emission/stake yield, plus aggregates (totals, subnet/validator counts, overall return, and how concentrated the wallet's stake is across subnets).

This account's reconstructed nominator-side positions (by SS58 coldkey): what it holds delegated across every hotkey/subnet — hotkey, netuid, share_fraction (0-1, this account's share of that hotkey's alpha-pool shares on that subnet), and the derived stake_tao.

Fan out to five of an account's live views in a single round trip: live TAO balance, cross-subnet portfolio (hotkey-scoped), cross-subnet footprint (registered subnets), nominator-side positions (coldkey-scoped), and the most recent chain events (default 10, cap with recent_events_limit).

Fetch the latest-only on-chain personal identity for one account (name, url, image, discord, github, and the rest of the MetagraphInfo.

Fetch the append-only diff-tracking timeline for one account's on-chain identity, newest first.

Fetch one account's per-day position history in one subnet: stake, emission, rank, trust, incentive, dividends per snapshot_date, newest first.

Fetch one account's StakeAdded vs StakeRemoved flow per subnet over the requested window (7d, 30d, or 90d; default 30d): per-subnet net and gross flow with direction labels, account totals, an HHI concentration of where its flow is focused, and the dominant subnet.

Fetch one account's StakeMoved (re-delegation) footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's movement count with the first and last StakeMoved timestamps, plus account totals, an HHI concentration of where its re-delegation churn is focused, and the dominant subnet.

Fetch one account's AxonInfoRemoved (axon teardown) footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's removal count with the first and last AxonInfoRemoved timestamps, plus account totals, an HHI concentration of where its teardown activity is focused, and the dominant subnet.

Fetch one account's PrometheusServed (telemetry endpoint) footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's announcement count with the first and last PrometheusServed timestamps, plus account totals, an HHI concentration of where its telemetry activity is focused, and the dominant subnet.

Fetch one account's NeuronRegistered registration footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's registration count with the first and last NeuronRegistered timestamps, plus account totals, an HHI concentration of where its registration activity is focused, and the dominant subnet.

Fetch one account's (validator hotkey's) WeightsSet weight-setting footprint per subnet over the requested window (7d or 30d; default 7d): each subnet's weight-set count with the first and last WeightsSet timestamps, plus account totals, an HHI concentration of where its weight-setting activity is focused, and the dominant subnet.

Fetch one account's AxonServed axon-endpoint serving footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's announcement count with the first and last AxonServed timestamps, plus account totals, an HHI concentration of where its serving activity is focused, and the dominant subnet.

Fetch one account's NeuronDeregistered eviction footprint per subnet over the requested window (7d, 30d, or 90d; default 30d): each subnet's deregistration count with the first and last NeuronDeregistered timestamps, plus account totals, an HHI concentration of where its eviction activity is focused, and the dominant subnet.

Fetch the per-day activity series for one account by its SS58 hotkey address, from the account_events_daily rollup: event count, kinds seen, and first/last block per day.

Fetch the extrinsics (transactions) signed by one account by its SS58 address, newest first: block, extrinsic index, hash, call module and function, success flag, and fee.

Fetch the native-TAO Balances.

Rank who one account transacts native TAO with, by total transfer volume, from the Balances.

Fetch the recent-block feed (newest first) from the chain block-explorer tier: block number, hash, parent hash, author, extrinsic count, event count, and timestamp.

Fetch the detail for one block by its block number (integer) or 0x block hash (64-char hex).

Fetch the extrinsics in one block by ref (numeric block_number or 0x block_hash), in natural read order (extrinsic_index ASC).

Fetch the decoded chain events in one block by ref (numeric block_number or 0x block_hash), in natural read order (event_index ASC).

Fetch the extrinsic feed (newest first) from the chain extrinsic tier, with optional filters: block (exact height), signer (SS58 address), call_module (e.

Fetch the detail for one extrinsic by its 0x extrinsic hash (e.

Fetch the extrinsics feed filtered to the Sudo pallet — subtensor's root-origin call table (it has no Council/Senate, only Sudo).

Fetch the current Sudo::Key holder, queried live from finney RPC at request time (1h KV cache).

Fetch live global Subtensor protocol/governance parameters -- TaoWeight, StakeThreshold, PendingChildKeyCooldown -- queried live from finney RPC at request time (300s KV cache).

Fetch the live drand randomness-beacon status -- LastStoredRound and OldestStoredRound -- queried live from finney RPC at request time (30s KV cache).

Fetch the extrinsics feed filtered to the AdminUtils pallet — subtensor's root-origin hyperparameter/network-config change pathway (re-scoped from a Council/Senate framing subtensor doesn't have).

List every network this API can address — mainnet, testnet, local — with its canonical id, chain name, every accepted alias, and the route families it serves, does not serve, or serves only partially.

Fetch the spec-version transition timeline: the earliest known block at each distinct runtime spec_version observed, ascending by block number.

Fetch the site-wide accounts leaderboard: every currently-registered hotkey (miners included, not just validator_permit=1 rows), sortable by total_stake (default), total_emission, subnet_count, uid_count, validator_count, stake_dominance, or last_active.

Fetch the balance-based top-holder leaderboard (#6741/#6743): every account (coldkey) with a nonzero free balance and/or delegated stake position, with free/delegated/total TAO columns list_accounts explicitly cannot derive.

Fetch every raw pallet.

Fetch raw pallet.

Fetch the chain-activity aggregate from the all-events tier: the pallet.

Fetch the raw recent decoded chain-events feed (newest first) from the all-events tier: each event's block, event index, pallet, method, decoded args, phase, and emitting extrinsic index.

Fetch the extrinsic call-mix breakdown over a 7d or 30d window: each call_module (or call_module/call_function with group_by=module_function) by count and share of all extrinsics.

Fetch the windowed most-active-account leaderboard: signers ranked by extrinsic count (default) or total fees over the requested window (7d or 30d), with total fees, tips, and last signed block.

Fetch fee/tip market analytics over the requested window (7d or 30d): a per-UTC-day fee series (totals + averages) plus a top-fee-payer list.

Fetch network-wide neuron-registration activity over the requested window (7d or 30d; default 7d) across every subnet with observed registration activity: a per-subnet registration leaderboard (ranked by NeuronRegistered count) plus the network rollup, computed live from the account_events NeuronRegistered stream.

Fetch the network-wide neuron-deregistration leaderboard over the requested window (7d or 30d; default 7d): each subnet ranked by NeuronDeregistered events with its distinct-deregistered-hotkey count and deregistrations-per-hotkey intensity, plus a network rollup (distinct deregistered hotkeys, total deregistrations, deregistrations per hotkey) and the count/mean/min/p25/p50/p75/p90/max spread of per-subnet intensity, summed live from the account_events stream.

Fetch network-wide Balances.

Fetch the network-wide native-TAO transfer-corridor leaderboard over the requested window (7d or 30d; default 7d): the top directed sender->receiver pairs ranked by volume (default) or transfer count, each with its TAO volume, transfer count, and last block/time, plus a network rollup (total volume, transfer count, unique corridor count, and the top corridor's share of total volume).

Fetch daily network-activity aggregates over the requested window (7d or 30d): per-UTC-day extrinsic/event/block counts, success rate, and unique signers, newest day first.

List the callable services (subnet-api, openapi, sse) one subnet exposes, each with base URL, auth requirement, machine-readable schema URL, current health, and call eligibility.

Fetch the captured OpenAPI/Swagger schema for a subnet surface by its schema surface_id (from list_subnet_apis service.

Fetch a captured, sanitized live request/response sample for a no-auth GET surface by its surface_id (from list_subnet_apis / the fixtures index at /metagraph/fixtures.

Fetch one provider/source by its slug: its identity, authority, the subnets and surfaces it backs, and its catalogued endpoints.

Fetch the index of registered data providers/sources backing the registry: each provider's id, kind, authority, name, and the subnets, surfaces, and endpoints it backs.

Fetch the catalog of curated public surfaces across all subnets: each surface's subnet (netuid), kind, provider, title, url, and review state.

Fetch unpromoted candidate surfaces across all subnets: surfaces that have been discovered or proposed but not yet curated/promoted, each with its subnet (netuid), kind, provider, review state, and confidence.

Fetch the network-wide catalog of generalized endpoint resources: every monitored public endpoint/surface across providers and subnets, each with its kind, layer, provider, subnet (netuid), publication state, and probe-derived status/latency/score.

Fetch the public evidence ledger: the append-only record of provenance and verification evidence behind registry surfaces (what was checked, for which subnet, and the outcome).

Fetch the catalog of monitored Bittensor base-layer RPC endpoints and their status (each endpoint's URL, network, and probe-derived health/latency).

Fetch the source-snapshot ledger: the per-source input hash and record count captured for each registry data source at ingest time.

Fetch the contributor review queue of subnet profile-completeness gaps: which subnets have incomplete public-safe profiles (missing identity, native name, confidence, or promotion signals) and are worth profile enrichment.

Fetch the load-balanced Bittensor RPC pool scores: each pool's kind, eligible endpoint count, total endpoint count, and probe-derived routing score, as used to route the public RPC proxy.

Fetch the monitored endpoint resources for one subnet by netuid: each endpoint/surface with its kind, layer, provider, publication state, and probe-derived status/latency/score.

Fetch monitored endpoint resources for one subnet by netuid: each endpoint with kind, layer, provider, publication state, and probe-derived status, latency, and score.

Fetch curated public interface surfaces for one subnet by netuid: each promoted surface with its kind, provider, title, url, and review state.

Fetch per-surface health records for one subnet by netuid: each monitored surface with its kind, provider, probe-derived status and classification, latency, and last-checked/last-ok times.

Fetch the unpromoted candidate surfaces for one subnet by netuid: surfaces discovered or proposed for the subnet but not yet curated/promoted, each with its kind, provider, and review state.

Fetch pending candidate surfaces for one subnet by netuid: each proposed surface with its kind, provider, review state, and confidence.

Fetch the public evidence-ledger claims for one subnet by netuid: the provenance and verification evidence recorded for that subnet's surfaces (what was checked and the outcome).

Fetch public evidence-ledger claims for one subnet by netuid: provenance and verification evidence recorded for that subnet's surfaces (what was checked and the outcome).

Fetch the curated public surfaces for one subnet by netuid: each promoted surface with its kind, provider, title, url, and review state.

Fetch the index of captured live request/response fixtures: which subnet surfaces carry a sanitized real sample, with capture status and metadata.

Fetch the index of captured OpenAPI/Swagger schema snapshots across subnets: which surfaces publish a machine-readable schema, its hash, and drift status (new/unchanged/changed).

Fetch slim search-index documents from the registry: subnet/provider entries with title, slug, kind, and netuid without the heavy per-document token blobs in search.

Keyword-search the full registry search index: subnet, surface, and provider documents with their per-document token blobs, mirroring GET /api/v1/search.

Fetch per-subnet curation states from the registry: coverage_level, curation_level, source counts, and review posture for every active subnet.

Fetch per-subnet interface gap reports from the registry: missing or unsupported public interface facets, gap_count, coverage_level, and curation_level for every active subnet.

Fetch the prioritized all-subnet enrichment queue from the registry: contributor-facing targets with lane, priority_score, missing surface kinds, direct-submission kinds, evidence_action, and recommended_action per subnet.

Fetch subnets worth deeper adapter work from the registry: recommended_adapter_kind, operational and candidate API kinds, priority_score, and reason_codes per subnet.

Fetch detailed candidate evidence entries from the registry: per-subnet evidence_action, lane, missing surface kinds, direct_submission_kinds, and priority_score for contributor enrichment work.

Fetch the contributor-targeted review gap priority board from the registry: per-subnet priority_score, missing surface kinds, surface and candidate counts, curation_level, and review_state.

Fetch the contributor-facing enrichment target board from the registry: per-subnet target_type, target_action, lane, priority_score, missing surface kinds, submission_route, and recommended_action.

Fetch generalized endpoint pool scores from the registry: each pool's kind, eligible endpoint count, total endpoint count, and probe-derived routing score.

Fetch probe-derived endpoint incidents from the registry: active endpoint failures and degradations with severity, state, provider, subnet, and probe metadata.

Fetch the monitored endpoint resources for one provider by slug: each endpoint/surface with its kind, layer, subnet (netuid), publication state, and probe-derived status/latency/score.

Fetch the maintainer-approved cross-network subnet lineage: which testnet subnets have graduated to mainnet (mainnet ↔ testnet pairs with the match evidence), plus any flagged broken links.

Fetch the registry's freshness and staleness state: per-source last-captured timestamps, staleness windows, and current status for each data lane (adapter snapshots, the chain-event index, operational surface health, etc.

Fetch the registry's public artifact contract metadata: every baked artifact path, storage tier, schema reference, and consumer notes.

Fetch the per-provider source-health rollup: for each provider/source, the count of candidate surfaces and how they classify (live / redirected / dead), endpoint and RPC-endpoint counts, verification-result count, and an overall status.

Fetch the latest generated registry changelog: artifact added/modified/removed rows, subnet added/removed/renamed events, and coverage deltas since the previous publish.

Fetch registry "what changed" items as structured JSON: registry changes (subnets/artifacts/coverage added, removed, renamed, or updated), operational incidents (surface downtime), coverage gaps (ranked enrichment targets), or one subnet's combined registry+incidents feed.

Fetch the generated build summary: artifact inventory counts and sizes, subnet/provider/surface totals, coverage rollup, and publish metadata.

Fetch metagraphed's OWN uptime verdict: the api/site/publish component views with their latest probe state and trailing-90-day daily uptime ratios, plus the rolled-up operational/degraded/outage verdict.

Fetch one adapter-backed public metrics snapshot for a subnet slug: the captured adapter snapshot, extension metadata, and netuid linkage.

Fetch the machine-readable agent capability catalog.

Fetch the machine-readable AI-resources index: the copyable agent prompt (/agent.

Fetch RPC reverse-proxy usage analytics over a 7d or 30d window: total request volume, error and failover rates, cache-hit rate, latency p50/p95 and average, per-endpoint request distribution, per-network breakdown, and bounded time buckets (1h for 7d, 6h for 30d).

Return the best currently-eligible Bittensor base-layer RPC/WSS endpoint(s), scored and filtered by live health (down endpoints are excluded).

Proxy a single read-only, allowlisted Substrate/Subtensor JSON-RPC call (chain_getBlock, chain_getBlockHash, chain_getFinalizedHead, chain_getHeader, rpc_methods, state_getRuntimeVersion, system_chain, system_health, system_name, system_properties, system_version, plus the state-query methods state_getStorage/state_getKeysPaged) against the finney or test network, with the same method allowlist, state-query param validation, rate limiting, and endpoint failover as the public proxy.

Execute an arbitrary read-only GraphQL query against the metagraph GraphQL API (POST /api/v1/graphql) and return its { data, errors } result.

Fetch the registry-wide summary: overall completeness, the most complete subnets, coverage-level counts, and the latest registry changes.

Fetch the registry-wide coverage rollup: surface counts, official-surface coverage, completeness scores, domain breakdown, and candidate/probe counts.

Fetch the machine-usable coverage-depth scorecard and ranked enrichment queue: per-subnet tier/score/priority rows plus the ranked queue of enrichment targets.

Fetch the coverage-depth scorecard's ranked enrichment targets: which subnets need schema, fixture, example/SDK, provenance, candidate-review, or hard-blocker follow-up next.

Fetch one subnet's interface gap priorities and contributor enrichment queue: missing surface kinds, priority scores, recommended actions, and copyable submission hints.

Fetch interface gap priorities for one subnet by netuid: the surface kinds still missing, the subnet's curation level, and the review state driving contributor targeting.

Compare subnets across the network by the economics a miner or validator actually weighs, as ranked boards: open-slots (most room to register), cheapest-registration (lowest cost to join, registration open), highest-emission (where the emission/yield is concentrated), validator-headroom (open validator permits), biggest-alpha-gain-1d / biggest-alpha-gain-7d (largest positive alpha-price %-change).

Meaning-based (vector) search across Bittensor subnets, surfaces, and providers.

Natural-language Q&A grounded in the registry (RAG).

Goal-shaped discovery: describe a task in plain language ('summarize a PDF', 'generate an image', 'get a price feed') and get the Bittensor subnets that can actually do it — only subnets exposing callable services, each with its integration readiness, callable service kinds, base URL, health, and a next step.

Goal-shaped integration guide for one subnet: how to actually call it.

Live-probe a single catalogued surface (by surface_id, stable surface_key, or deprecated surface_id alias) or a subnet's primary surface (by netuid) and return its current health — status, latency, and whether it is callable right now.

Read a catalogued surface (by surface_id, stable surface_key, or deprecated surface_id alias) and return its real response body -- not just health/status metadata like verify_integration.

Issue a POST, PUT, PATCH or DELETE against a catalogued surface, and return its real response body.

Store one credential for a catalogued auth_required surface, bound to YOUR authenticated identity, so later call_subnet_surface invocations resolve it without you passing it as a tool argument (where it would land in client logs and the conversation transcript).

List the surfaces YOU have registered a credential for with store_surface_credential: surface_id, credential shape, when it was stored, and when it expires.

Remove the credential YOU registered for one surface.

Run one maintainer-curated, parameterized query template -- a third query modality sitting between the fixed REST-mirror tools above and the open query_graphql tool: narrower than raw GraphQL, but callable without knowing the schema.

Identify + decode a raw Ethereum.

Fetch the live H160 -> SS58 address mapping for one EVM address, via the AddressMapping EVM precompile's addressMapping(address) (#6725/#6728) -- a deterministic function of the runtime's configured mapping algorithm, queried live rather than replicated client-side.

Call this ONLY when you have looked through the available tools and none of them can do what you need.

Full-text search across Bittensor subnets by name, slug, capability, or keyword.

Enumerate the full Bittensor subnet registry, paginated.

Find Bittensor subnets that expose callable services (APIs, OpenAPI schemas, SSE streams) matching a capability or category.

Fetch the composed overview for one subnet by netuid: identity, completeness, curated surfaces, health summary, gaps, and counts.

Fetch live operational health for one subnet's surfaces (probed every ~15 minutes): per-surface status, latency, and last-ok timestamps.

Fetch one subnet's live economics: validator and miner counts, registration cost and whether registration is open, open slots and a miner-readiness signal, total and max stake, alpha price, emission share, and pool reserves.

Fetch the live network-wide economics scorecard: per-subnet validator and miner counts, registration cost and whether registration is open, open slots, stake, alpha price, emission share, and summary totals.

Fetch the per-day split of one subnet's emission by recipient class over a 7d, 30d, or 90d window (default 30d): how much went to the owner, to validators, and to miners, plus how many validator and miner UIDs actually earned anything that day.

Measure whether a subnet's registered miners actually EARN, over a 7d, 30d or 90d window (default 30d).

Read what one subnet SAYS it takes to run a miner or a validator there, beside what the chain EXACTLY charges to enter and what miners there actually earned.

Place several subnets side by side across registry structure, economics, and live probe health in one call.

Fetch the USD price of one TAO (#9609) with the derivation behind it, plus the recent series.

List the callable services (subnet-api, openapi, sse) one subnet exposes, each with base URL, auth requirement, machine-readable schema URL, current health, and call eligibility.

Fetch the captured OpenAPI/Swagger schema for a subnet surface by its schema surface_id (from list_subnet_apis service.schema_source.surface_id when present, otherwise the service surface_id).

Fetch registry "what changed" items as structured JSON: registry changes (subnets/artifacts/coverage added, removed, renamed, or updated), operational incidents (surface downtime), coverage gaps (ranked enrichment targets), or one subnet's combined registry+incidents feed.

Return the best currently-eligible Bittensor base-layer RPC/WSS endpoint(s), scored and filtered by live health (down endpoints are excluded).

Fetch the registry-wide summary: overall completeness, the most complete subnets, coverage-level counts, and the latest registry changes.

Fetch the registry-wide coverage rollup: surface counts, official-surface coverage, completeness scores, domain breakdown, and candidate/probe counts.

Meaning-based (vector) search across Bittensor subnets, surfaces, and providers.

Natural-language Q&A grounded in the registry (RAG).

Read a catalogued surface (by surface_id, stable surface_key, or deprecated surface_id alias) and return its real response body -- not just health/status metadata like verify_integration.

Store one credential for a catalogued auth_required surface, bound to YOUR authenticated identity, so later call_subnet_surface invocations resolve it without you passing it as a tool argument (where it would land in client logs and the conversation transcript).