{"openapi":"3.1.0","info":{"title":"Aptos Validators & Staking API","version":"1.0.0","description":"The Aptos proof-of-stake validator set and staking economics, live from the official public Aptos fullnode — no key, nothing cached. Where the Aptos account and resource readers cover balances and the view reader runs Move calls, this curates the consensus layer they miss. Rank the active validators by voting power — each with its share of total network stake, its operator and its pool address. Read the network-wide staking config: minimum and maximum stake (in APT), the recurring lockup period, the per-epoch reward rate, the voting-power increase limit and the current epoch. And inspect any single stake pool for its active, inactive and pending stake (in APT), the operator that runs the validator, the account delegated to vote, and the unlock timestamp. The staking-and-validator layer for Aptos wallets, staking dashboards, delegators and on-chain analytics. Live from fullnode.mainnet.aptoslabs.com.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/aptosvalidators-api","description":"oanor gateway"}],"tags":[{"name":"Validators"},{"name":"Staking"},{"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/validators":{"get":{"operationId":"get_v1_validators","tags":["Validators"],"summary":"Active validators ranked by voting power","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max validators to return (1-200)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Active Aptos validators ranked by voting power (proportional to staked APT). voting_power_pct is the validator's share of total network stake. Use an address with /v1/pool for the pool's stake breakdown.","count":25,"source":"Aptos fullnode","validators":[{"address":"0xf0d49cff005d03312934ce027e30f4a84143d5af53623b30036e7dac1510c218","validator_index":52,"voting_power_apt":25902742.62137633,"voting_power_pct":3.3897,"voting_power_octas":"2590274262137633"},{"address":"0x2738d91e160d9be37cd9689177546b567e28a3644b702388fd2c2be9c97682de","validator_index":84,"voting_power_apt":25467544.87835734,"voting_power_pct":3.3328,"voting_power_octas":"2546754487835734"},{"address":"0x8dd8b23892be142c2ec4b7e1427584c97403e570cde4e6d9a81d2b220c884af5","validator_index":45,"voting_power_apt":25467479.89569687,"voting_power_pct":3.3328,"voting_power_octas":"2546747989569687"},{"address":"0xcfb4330556f9e4d3283a944d4c1763113cee40143182e8d874437368bd1b33ba","validator_index":50,"voting_power_apt":21958249.28992054,"voting_power_pct":2.8736,"voting_power_octas":"2195824928992054"},{"address":"0xb3b1719eece4c1bbb074115df8886a133ea863127c77c9f0a5ed5161a4a4393","validator_index":79,"voting_power_apt":20550551.64835198,"voting_power_pct":2.6893,"voting_power_octas":"2055055164835198"},{"address":"0x9bfd93ebaa1efd65515642942a607eeca53a0188c04c21ced646d2f0b9f551e8","validator_index":21,"voting_power_apt":20428285.88334988,"voting_power_pct":2.6733,"voting_power_octas":"2042828588334988"},{"address":"0x30e2f4236a88d2201b9bc27365d8516ab9cb3b53d82cee8c76369a3a01cef6ec","validator_index":48,"voting_power_apt":18877634.495223,"voting_power_pct":2.4704,"voting_power_octas":"1887763449522300"},{"address":"0x346361873c235e1a300fd67a2e8b7bd1ea3744001b2e0d1942317c4c8521f5dd","validator_index":31,"voting_power_apt":16357469.32957666,"voting_power_pct":2.1406,"voting_power_octas":"1635746932957666"},{"address":"0xda418307cff595ced2af5eb471ec11b1ad6a4907ef57d6e2eeb253bdd5bd9d0d","validator_index":18,"voting_power_apt":16089626.14799956,"voting_power_pct":2.1056,"voting_power_octas":"1608962614799956"},{"address":"0xf923e8203e8d534c7357e0761179a76d6593e21c53d5f8120044c7d2cc650679","validator_index":61,"voting_power_apt":15470387.3181279,"voting_power_pct":2.0245,"voting_power_octas":"1547038731812790"},{"address":"0xab4a80ccc772691cb03e3ee8d22b5c13acc92472dd4a19987c1aade2691404a","validator_index":51,"voting_power_apt":15347926.59480106,"voting_power_pct":2.0085,"voting_power_octas":"1534792659480106"},{"address":"0x324df1e27c4129a58d73851ae0e9366064dc666a73e747051e203694a4cb257","validator_index":88,"voting_power_apt":14291317.00906345,"voting_power_pct":1.8702,"voting_power_octas":"1429131700906345"},{"address":"0x23ce6b936c6c8e9114950c4bbbd454e1d4c6a4e3842a50e367b9bc0046aacf7b","validator_index":81,"voting_power_apt":13675923.96471615,"voting_power_pct":1.7897,"voting_power_octas":"1367592396471615"},{"address":"0xd7b10a9ddee853b3585dd1efd4902ab3ad4f482b94425a3780cc39e79e6d398","validator_index":30,"voting_power_apt":13364101.36728035,"voting_power_pct":1.7489,"voting_power_octas":"1336410136728035"},{"address":"0x4b187c13fa53cd3ee9a964641bf53eabd89c5e7378ea2266cfab186f066c1815","validator_index":72,"voting_power_apt":13223095.14926364,"voting_power_pct":1.7304,"voting_power_octas":"1322309514926364"},{"address":"0xdb5247f859ce63dbe8940cf8773be722a60dcc594a8be9aca4b76abceb251b8e","validator_index":34,"voting_power_apt":12434000.96347247,"voting_power_pct":1.6272,"voting_power_octas":"1243400096347247"},{"address":"0x4534b92f2f9c66d58b6acd7f39211f4c1a1c96b0cea3189c2dcb692440723020","validator_index":69,"voting_power_apt":12432646.7654072,"voting_power_pct":1.627,"voting_power_octas":"1243264676540720"},{"address":"0xc32f662cd9718f02d8a8e5628f8f642fa27cd9b5f457b406ed734901a4939e34","validator_index":87,"voting_power_apt":12112666.55190677,"voting_power_pct":1.5851,"voting_power_octas":"1211266655190677"},{"address":"0x61b64e39286bf11cd642f03417ab725f15a09dcbf8be23b752851c3c33e74d7b","validator_index":73,"voting_power_apt":11905314.20965125,"voting_power_pct":1.558,"voting_power_octas":"1190531420965125"},{"address":"0x20ae7e67009dbc40e5a0c68e99c4287e2764fe22d135bcd318100de1b7950c28","validator_index":57,"voting_power_apt":11668091.5762357,"voting_power_pct":1.5269,"voting_power_octas":"1166809157623570"},{"address":"0xf747e3a6282cc0dee1c89239c529b039c64fe48e88b50e5cedd40e9c094800bb","validator_index":58,"voting_power_apt":10878449.01204131,"voting_power_pct":1.4236,"voting_power_octas":"1087844901204131"},{"address":"0x3eaf3ebc49555c705c34ec1ffe77404bdb7383b388476c36538b92b7b1b806c9","validator_index":95,"voting_power_apt":10829672.41087099,"voting_power_pct":1.4172,"voting_power_octas":"1082967241087099"},{"address":"0xc84eb99fa08a8dbae9cf8be48b312a946c7cb5f4d109c59b49aa3d446180034e","validator_index":70,"voting_power_apt":10402516.59987772,"voting_power_pct":1.3613,"voting_power_octas":"1040251659987772"},{"address":"0xd89481a2f4ff5598f8a6e83e67f21dba6a0df56a1bc35b9c67a2de6dce166b30","validator_index":29,"voting_power_apt":10288258.61635606,"voting_power_pct":1.3464,"voting_power_octas":"1028825861635606"},{"address":"0x3edbf3e6444054c2a5a391221c9023882d0b2478576c445923a39b3bd0cde0a3","validator_index":41,"voting_power_apt":10121471.24347168,"voting_power_pct":1.3245,"voting_power_octas":"1012147124347168"}],"pending_active":0,"pending_inactive":0,"total_staked_apt":764150366.7672865,"active_validator_count":97,"total_voting_power_octas":"76415036676728660"},"meta":{"timestamp":"2026-06-14T08:03:48.647Z","request_id":"df957fd8-6a77-47e3-8985-654ae814031d"},"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/config":{"get":{"operationId":"get_v1_config","tags":["Staking"],"summary":"Network staking config: stake bounds, lockup, reward rate, epoch","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Network-wide Aptos staking parameters from on-chain staking_config plus the current epoch. Stakes are in APT; reward_rate_per_epoch is the fractional reward minted to stake each epoch (~2h on mainnet).","epoch":16169,"source":"Aptos fullnode","total_staked_apt":764150366.7672865,"maximum_stake_apt":50000000,"minimum_stake_apt":1000000,"recurring_lockup_days":14,"recurring_lockup_secs":1209600,"reward_rate_per_epoch":1.5981e-5,"active_validator_count":97,"last_reconfiguration_time":"1781423914776148","allow_validator_set_change":true,"voting_power_increase_limit_pct":10},"meta":{"timestamp":"2026-06-14T08:03:49.061Z","request_id":"a155c3f8-2df0-4bda-b51c-d01184f7ae58"},"status":"ok","message":"Staking config 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/pool":{"get":{"operationId":"get_v1_pool","tags":["Staking"],"summary":"A single stake pool: stake breakdown, operator, lockup","description":"","parameters":[{"name":"address","in":"query","required":false,"description":"Validator / stake-pool account address (0x...); omit for the top validator","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A single Aptos stake pool: its active/inactive/pending stake (in APT), the operator that runs the validator, the account allowed to vote with the stake, and the unlock timestamp. Omit address for the top validator's pool.","source":"Aptos fullnode","address":"0xf0d49cff005d03312934ce027e30f4a84143d5af53623b30036e7dac1510c218","total_apt":25905105.71655352,"active_apt":25901044.73622319,"inactive_apt":2363.09517719,"delegated_voter":"0xf0d49cff005d03312934ce027e30f4a84143d5af53623b30036e7dac1510c218","operator_address":"0x6f7178a48dc2f97fda6bec6ae284da1360b481ee7e049e956bf68d23395c034f","locked_until_secs":1781812398,"pending_active_apt":0,"pending_inactive_apt":1697.88515314},"meta":{"timestamp":"2026-06-14T08:03:49.197Z","request_id":"5b0b4d92-b45e-44c1-af5f-af674f4d813a"},"status":"ok","message":"Stake pool 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":{"active_validators":97,"top_voting_power_pct":3.3897},"source":"official public Aptos fullnode REST API (fullnode.mainnet.aptoslabs.com), keyless","service":"aptosvalidators-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pool":"One stake pool's stake breakdown, operator and lockup (address=0x...; omit for top).","GET /v1/config":"Network staking config: min/max stake, lockup, reward rate, epoch.","GET /v1/validators":"Active validators ranked by voting power, with network share (limit)."},"description":"Read the Aptos proof-of-stake validator set and staking economics live from the official public fullnode: rank active validators by voting power (with each one's network share, operator and pool), read the network staking config (min/max stake, lockup, reward rate, current epoch), and inspect any single stake pool's active/inactive/pending stake. The staking-and-validator layer for Aptos wallets, staking dashboards and analytics. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:49.259Z","request_id":"33df2745-9834-434e-9934-65e43e22057b"},"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":7400,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":990,"monthly_call_quota":141000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3480,"monthly_call_quota":792000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9450,"monthly_call_quota":5250000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/aptosvalidators-api"}