API referenceValidators
Global Validators
Last updated
Last updated
Fetch the network-wide validator/operator leaderboard: validator-permit identities grouped across current subnet memberships, with trust metrics, emission totals, and membership rows. Neuron stake is voting weight, not independently measured investment principal. Legacy capital totals, stake dominance, and APY are unavailable (null); the APY eligible count is zero. Membership stake_alpha retains its legacy name for raw voting-weight evidence and must not be priced or summed across subnets. Sort by subnet_count (default), uid_count, avg_validator_trust, max_validator_trust, or total_emission; total_stake and stake_dominance remain accepted compatibility sorts with unavailable values and deterministic tie ordering. Limit defaults to 20, max 2000.
Column to rank the result by; pair with order for direction. Options are per-tool; see this parameter's enum. Defaults to subnet_count.
"subnet_count"Value in
Maximum number of rows to return in one page (at most 2000). A larger value, or a non-positive one, is rejected with 400 invalid_query -- so a short page means the result set is exhausted, not that the server quietly capped you (#9916). Omitted, the server applies 20.
1 <= value <= 200020Response format override. Use csv to download the route rows as text/csv; json keeps the default response envelope.
"json"Value in
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/validators"{ "data": { "block_number": 5000000, "captured_at": "2026-06-01T00:00:00.000Z", "limit": 1, "schema_version": 1, "sort": "avg_validator_trust", "validator_count": 1, "validators": [ { "alpha_stake_tao": null, "apy_estimate": null, "apy_estimate_eligible_subnet_count": 0, "avg_validator_trust": 0.5, "coldkey": "example", "coldkey_count": 1, "coldkey_identity": { "additional": "example", "captured_at": "2026-06-01T00:00:00.000Z", "description": "Example description.", "discord": "example", "github": "https://api.metagraph.sh/example", "has_identity": false, "image": "https://api.metagraph.sh/example", "name": "Example Subnet", "url": "https://api.metagraph.sh/example" }, "featured": false, "hotkey": "example", "latest_block_number": 5000000, "latest_captured_at": "2026-06-01T00:00:00.000Z", "max_validator_trust": 0.5, "nominator_count": 1, "realized_return_1d": null, "realized_return_1d_as_of": null, "realized_return_1m": null, "realized_return_1m_as_of": null, "realized_return_1w": null, "realized_return_1w_as_of": null, "root_stake_tao": null, "stake_dominance": null, "subnet_count": 1, "subnets": [ { "emission_alpha": 0.5, "netuid": 7, "stake_alpha": 0.5, "uid": 1, "validator_trust": 0.5 } ], "take": 0.5, "total_emission_tao": 0.5, "total_stake_tao": null, "uid_count": 1 } ] }, "meta": { "artifact_path": "example", "cache": "short", "catalog_paging": { "reason": "catalog_changed" }, "contract_version": "2026-06-29.1", "generated_at": "2026-06-01T00:00:00.000Z", "observed_through": "2026-06-01T00:00:00.000Z", "pagination": { "collection": "example", "cursor": 1, "limit": 1, "next_cursor": 1, "order": "asc", "returned": 1, "snapshot": "v1.a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1", "sort": "example", "total": 1 }, "published_at": "2026-06-01T00:00:00.000Z", "source": "live-cron-prober", "stale_contract": { "built_under": "example", "live": "example" } }, "ok": true, "schema_version": 1}