{"openapi":"3.1.0","info":{"title":"Avalanche P-Chain Validators & Staking API","version":"1.0.0","description":"The Avalanche Primary Network validator set — Avalanche's proof-of-stake — live from the official public Avalanche API, no key, nothing cached. Avalanche secures its Primary Network with hundreds of permissionless validators who stake AVAX (and accept delegations) on the P-Chain; this is the first Avalanche reader in the marketplace. Rank the current validators by stake weight, each with its node id, total stake (own plus delegated, in AVAX), share of network stake, uptime, delegation fee, delegator count and the validation reward pending at the end of its term. Look up a single validator by node id for its stake, rank, delegators and uptime. And read a live staking overview — the validator count, how many are connected, the total AVAX staked on the Primary Network, the current circulating AVAX supply and the average uptime of the set. The validator-and-staking layer for Avalanche wallets, staking dashboards, delegators and analytics. Live from api.avax.network.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/avaxvalidators-api","description":"oanor gateway"}],"tags":[{"name":"Validators"},{"name":"Stats"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/validator":{"get":{"operationId":"get_v1_validator","tags":["Validators"],"summary":"One validator by node id: stake, rank, delegators, uptime","description":"","parameters":[{"name":"nodeID","in":"query","required":false,"description":"Avalanche node id (omit for the top validator)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A single Avalanche validator by node id: its total stake (in AVAX), rank, share of staked AVAX, delegators, delegation fee, uptime and pending reward. Omit nodeID for the top validator.","rank":1,"source":"Avalanche P-Chain","node_id":"NodeID-7pDhCWQKNrpCjTL6tB7uNvBUnBQ5amgob","end_time":1782792000,"connected":true,"start_time":1779143291,"uptime_pct":99.9811,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999999,"delegation_fee_pct":2,"potential_reward_avax":18738.2352},"meta":{"timestamp":"2026-06-14T17:04:35.506Z","request_id":"62ed8abe-0bdd-4953-a070-83ee6e9ac2fb"},"status":"ok","message":"Validator retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/validators":{"get":{"operationId":"get_v1_validators","tags":["Validators"],"summary":"Validators ranked by stake weight, with uptime, delegators, fee, reward","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max validators (1-200)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Avalanche Primary Network validators ranked by stake weight (own plus delegated, in AVAX). weight_pct is the validator's share of total staked AVAX; uptime_pct and connected reflect liveness; potential_reward_avax is the reward pending at the end of the validation period.","count":25,"source":"Avalanche P-Chain","validators":[{"rank":1,"node_id":"NodeID-7pDhCWQKNrpCjTL6tB7uNvBUnBQ5amgob","end_time":1782792000,"connected":true,"start_time":1779143291,"uptime_pct":99.9811,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999999,"delegation_fee_pct":2,"potential_reward_avax":18738.2352},{"rank":2,"node_id":"NodeID-8su1eeSjb4emswAx453du7ya3Pp8p2wSe","end_time":1782691200,"connected":true,"start_time":1776088350,"uptime_pct":99.9027,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999998.9963,"delegation_fee_pct":20,"potential_reward_avax":34791.7063},{"rank":3,"node_id":"NodeID-4pmpS7zznorSbCyDRxnfFriggu8pfz2Kv","end_time":1782921600,"connected":true,"start_time":1767314657,"uptime_pct":92.3062,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999990,"delegation_fee_pct":20,"potential_reward_avax":88629.1872},{"rank":4,"node_id":"NodeID-BXZr17N75YvPPaLqRPdyNATT1e8oxwRnF","end_time":1788278400,"connected":true,"start_time":1775060187,"uptime_pct":99.8827,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999990,"delegation_fee_pct":2,"potential_reward_avax":72734.7304},{"rank":5,"node_id":"NodeID-EboRgvw57eqzfafbFxwF3NAPLLFaNQjin","end_time":1798819200,"connected":true,"start_time":1767314532,"uptime_pct":92.5414,"weight_pct":1.6558,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2999990,"delegation_fee_pct":20,"potential_reward_avax":195555.9356},{"rank":6,"node_id":"NodeID-LWNS6TbpdhoMKk2sBJyNmte39qUukb23R","end_time":1789401600,"connected":true,"start_time":1779982387,"uptime_pct":99.8125,"weight_pct":1.6556,"delegated_avax":177.0683,"delegator_count":1,"stake_weight_avax":2999650.0688,"delegation_fee_pct":2,"potential_reward_avax":49911.213},{"rank":7,"node_id":"NodeID-C2ikimZSKuobNctfq7KobzQqSC9rTgZeJ","end_time":1782777600,"connected":true,"start_time":1776088350,"uptime_pct":99.9622,"weight_pct":1.6477,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2985428.6997,"delegation_fee_pct":20,"potential_reward_avax":35101.7758},{"rank":8,"node_id":"NodeID-AbhESXZPP3JjhMC8FrLaJar6n7DFqnWzd","end_time":1789380000,"connected":true,"start_time":1779991099,"uptime_pct":82.1263,"weight_pct":1.602,"delegated_avax":11792.6847,"delegator_count":41,"stake_weight_avax":2902499.98,"delegation_fee_pct":2,"potential_reward_avax":48115.4461},{"rank":9,"node_id":"NodeID-Hq4MpMS7A2WXakmiEEPC2S7iccY5zVEWA","end_time":1789387200,"connected":true,"start_time":1779981670,"uptime_pct":99.8858,"weight_pct":1.5895,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2879999.96,"delegation_fee_pct":10,"potential_reward_avax":47902.58},{"rank":10,"node_id":"NodeID-Q1ZzBXtcP9xUMTEUEks5cpx9f1q3tTjT5","end_time":1789390800,"connected":true,"start_time":1779981859,"uptime_pct":99.9156,"weight_pct":1.5895,"delegated_avax":119566.331,"delegator_count":75,"stake_weight_avax":2879999.96,"delegation_fee_pct":2,"potential_reward_avax":47906.8196},{"rank":11,"node_id":"NodeID-PCZJk3NoSfpD32WokykYHKrKuE814SAVM","end_time":1789394400,"connected":true,"start_time":1779981987,"uptime_pct":99.8423,"weight_pct":1.5895,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2879999.96,"delegation_fee_pct":10,"potential_reward_avax":47911.3779},{"rank":12,"node_id":"NodeID-7ZqQjoKjWR1esHETZQAqdo8EnC72iu9Gh","end_time":1789398000,"connected":true,"start_time":1779982114,"uptime_pct":99.9348,"weight_pct":1.515,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2744999.9699,"delegation_fee_pct":10,"potential_reward_avax":45669.8744},{"rank":13,"node_id":"NodeID-4gTwepTF5fcacXB7gdYZLTtfSFsYh4faj","end_time":1781751600,"connected":true,"start_time":1778991115,"uptime_pct":99.9685,"weight_pct":1.4902,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2699999.9688,"delegation_fee_pct":5,"potential_reward_avax":12742.9029},{"rank":14,"node_id":"NodeID-HqeE7wcqkoZwhnwv6ADxudhZvoSH76pcw","end_time":1788278400,"connected":true,"start_time":1775060291,"uptime_pct":99.9512,"weight_pct":1.4892,"delegated_avax":301789.1305,"delegator_count":3,"stake_weight_avax":2698210.636,"delegation_fee_pct":30,"potential_reward_avax":65388.416},{"rank":15,"node_id":"NodeID-KJyunRUfEvDFctr15YPumRauQtmY3YmAt","end_time":1789408800,"connected":true,"start_time":1779980231,"uptime_pct":99.9329,"weight_pct":1.4033,"delegated_avax":14393.086,"delegator_count":50,"stake_weight_avax":2542499.91,"delegation_fee_pct":2,"potential_reward_avax":42424.8717},{"rank":16,"node_id":"NodeID-BLjWtGBQU3PxgBSMvhiGxHGZ6Scn1gyyB","end_time":1782864000,"connected":true,"start_time":1776088349,"uptime_pct":99.9043,"weight_pct":1.3887,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2516075.6447,"delegation_fee_pct":20,"potential_reward_avax":29986.6336},{"rank":17,"node_id":"NodeID-CgTe7m2xyhEDguVWYEuYUCi75g7vMbvfj","end_time":1782777600,"connected":true,"start_time":1775059381,"uptime_pct":99.5664,"weight_pct":1.3798,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2499999.6789,"delegation_fee_pct":100,"potential_reward_avax":34260.3398},{"rank":18,"node_id":"NodeID-5zENHPe3oP2SdU13oTAvxZA2cEupejYhD","end_time":1799051340,"connected":true,"start_time":1768577189,"uptime_pct":99.8975,"weight_pct":1.1866,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2150000,"delegation_fee_pct":20,"potential_reward_avax":133999.4857},{"rank":19,"node_id":"NodeID-LL3tKdbQ9qCDRMm4cif2pGsxGDXsNNzBp","end_time":1782792000,"connected":true,"start_time":1779143052,"uptime_pct":99.987,"weight_pct":1.15,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2083537,"delegation_fee_pct":100,"potential_reward_avax":13015.8551},{"rank":20,"node_id":"NodeID-KWyfHHaNzGBA1xfNgYV8hy6W7iwfzhyhb","end_time":1791072000,"connected":true,"start_time":1760029448,"uptime_pct":99.8167,"weight_pct":1.1255,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2039258,"delegation_fee_pct":20,"potential_reward_avax":132449.7849},{"rank":21,"node_id":"NodeID-Jfx9FcVMQuy1FXGd53EuigXnCEgRQUUMg","end_time":1796317200,"connected":true,"start_time":1765221771,"uptime_pct":99.8536,"weight_pct":1.1176,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":2024994,"delegation_fee_pct":20,"potential_reward_avax":130440.8014},{"rank":22,"node_id":"NodeID-99hQvpQKJi1y7gTjD2icHKYwk1pNMHFhg","end_time":1800388800,"connected":true,"start_time":1768929833,"uptime_pct":99.7031,"weight_pct":1.1039,"delegated_avax":881592.7622,"delegator_count":559,"stake_weight_avax":2000000,"delegation_fee_pct":2,"potential_reward_avax":129185.2585},{"rank":23,"node_id":"NodeID-LDv41AQj1469CJsYDux9cLZepfaAWKzCr","end_time":1785708000,"connected":true,"start_time":1754679085,"uptime_pct":99.8817,"weight_pct":1.1039,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":1999999,"delegation_fee_pct":20,"potential_reward_avax":130884.348},{"rank":24,"node_id":"NodeID-Ar6tMT6KTw1bmTHK9o7dxR2FTe9NatcJV","end_time":1789416000,"connected":true,"start_time":1779980803,"uptime_pct":99.9167,"weight_pct":1.0187,"delegated_avax":11769.9145,"delegator_count":38,"stake_weight_avax":1845789.173,"delegation_fee_pct":2,"potential_reward_avax":30808.8591},{"rank":25,"node_id":"NodeID-8RHMe6kpbm2xvsn14W31oZz1z3WhFuoFq","end_time":1788255559,"connected":true,"start_time":1780321144,"uptime_pct":99.995,"weight_pct":0.9935,"delegated_avax":0,"delegator_count":0,"stake_weight_avax":1800000,"delegation_fee_pct":50,"potential_reward_avax":24983.9257}],"validator_count":670,"total_stake_avax":181183672.1604},"meta":{"timestamp":"2026-06-14T17:04:35.589Z","request_id":"a8bd4b2a-b131-48d9-8142-dde48d5aa386"},"status":"ok","message":"Validators retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Live staking overview: validators, total AVAX staked, supply, average uptime","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live Avalanche Primary Network staking overview: the active validator count, how many are connected, total delegations, average uptime, the total AVAX staked on the Primary Network and the current circulating AVAX supply.","source":"Avalanche P-Chain","connected_count":637,"validator_count":670,"total_stake_avax":225170964.3082,"total_delegations":27994,"average_uptime_pct":95.155,"current_supply_avax":472339753.6798},"meta":{"timestamp":"2026-06-14T17:04:35.727Z","request_id":"f0c190a0-033e-4f7b-b499-f956c393d74c"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"validators":670,"total_stake_avax":225170964.3082},"source":"official public Avalanche API (api.avax.network /ext/bc/P), keyless","service":"avaxvalidators-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/stats":"Live staking overview: validators, total AVAX staked, supply, average uptime.","GET /v1/validator":"One validator by node id: stake, rank, delegators, uptime (nodeID; omit for top).","GET /v1/validators":"Validators ranked by stake weight, with uptime, delegators, fee, reward (limit)."},"description":"Read the Avalanche Primary Network validator set live from the official public Avalanche API: rank validators by stake weight with their node id, total stake (own plus delegated), uptime, delegation fee and pending reward; look up a single validator by node id; and read a live staking overview (validator count, total AVAX staked, current supply, average uptime). The validator-and-staking layer for Avalanche wallets, staking dashboards and delegators. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:35.832Z","request_id":"34760e08-c29c-4503-ac53-0e651d2383b2"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7350,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":140000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":800000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9050,"monthly_call_quota":5100000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/avaxvalidators-api"}