API referenceValidators
Validators
Every Validators endpoint in the metagraphed API, with its method and path.
Last updated
7 endpoints.
- Compare Validators —
GET /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 Validators —
GET /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 Detail —
GET /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 Ranking —
GET /api/v1/validators/economics
Fetch every subnet ranked by what it costs to become an EARNING validator there. - Validator History —
GET /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 Nominators —
GET /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 Directory —
GET /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.