Skip to main content
API referenceValidators

Validators

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

Last updated

7 endpoints.

  • Compare ValidatorsGET /api/v1/compare/validators
    Place several validators side by side for a stake/delegate decision: each hotkey's take rate, estimated APY, nominator count, on-chain identity, and cross-subnet stake/emission/trust aggregates.
  • Global ValidatorsGET /api/v1/validators
    Fetch the network-wide validator/operator leaderboard: validator-permit identities grouped across all current subnet memberships, with trust metrics, cross-subnet stake/emission totals, stake dominance, and top membership rows.
  • Validator DetailGET /api/v1/validators/{hotkey}
    Fetch cross-subnet detail for one validator identity: its validator_permit=1 rows aggregated across every subnet it operates in — cross-subnet totals (stake, emission, avg/max trust) plus a full per-subnet performance table.
  • Validator Economics RankingGET /api/v1/validators/economics
    Fetch every subnet ranked by what it costs to become an EARNING validator there.
  • Validator HistoryGET /api/v1/validators/{hotkey}/history
    Fetch cross-subnet staked-over-time + rewards-per-1000-TAO history for one validator: one point per day, summed across every subnet it operates in that day (stake/emission totals, subnet count, and a normalized reward rate), computed live from the neuron_daily rollup tier.
  • Validator NominatorsGET /api/v1/validators/{hotkey}/nominators
    Fetch the nominator list for one validator: who has staked to it (across every subnet it operates in) over a 7d/30d/90d window, each with staked/unstaked/net/gross TAO and last activity, ranked by net_staked (default), gross_staked, or last_activity.
  • Validator Operator DirectoryGET /api/v1/validators/operators
    Fetch the compact validator operator directory used by the website: hotkeys sharing one observed owner account form a group, while unknown or conflicting owners remain separate.