{"openapi":"3.1.0","info":{"title":"EOS API","version":"1.0.0","description":"Live on-chain data from the EOS network (EOS), a delegated-proof-of-stake blockchain with a distinctive resource model where accounts stake EOS for CPU and network bandwidth and buy RAM for state: an account's liquid EOS balance, EOS staked for CPU and network, RAM quota and usage and live resource limits; the block producers ranked by DPoS vote weight; the live chain head, last irreversible block and current producer; and any account's balance of any EOS token.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/eos-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Producers"},{"name":"Token"},{"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/info":{"get":{"operationId":"get_v1_info","tags":["Network"],"summary":"Live EOS chain head, irreversible block and producer","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"eos","source":"EOS","chain_id":"aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906","consensus":"DPoS","native_token":"EOS","head_block_num":503585207,"server_version":"v1.0.5","head_block_time":"2026-06-10T14:00:01.000","head_block_producer":"newdex.bp","last_irreversible_block_num":503585205},"meta":{"timestamp":"2026-06-10T14:00:01.324Z","request_id":"f0630261-633b-4b7d-bce7-65264d021685"},"status":"ok","message":"Info 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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"An account balance, staked CPU/NET, RAM and resource limits","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"EOS account name","schema":{"type":"string"},"example":"binancecleos"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"voter":{"is_proxy":false,"staked_eos":0.8,"producers_voted":0},"source":"EOS","account":"binancecleos","created":"2018-06-29T08:01:48.000","permissions":["active","owner"],"cpu_limit_us":{"max":36176,"unit":"microseconds","used":147,"available":36029},"ram_used_pct":33.32,"cpu_staked_eos":40058.1,"net_staked_eos":4010.6,"net_limit_bytes":{"max":75970154,"unit":"bytes","used":129,"available":75970025},"ram_quota_bytes":182938,"ram_usage_bytes":60955,"liquid_balance_eos":0.2628},"meta":{"timestamp":"2026-06-10T14:00:01.656Z","request_id":"b3d4ff78-317e-4dfb-84b2-9a5ec9a62417"},"status":"ok","message":"Account 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/producers":{"get":{"operationId":"get_v1_producers","tags":["Producers"],"summary":"Block producers ranked by DPoS vote weight","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of producers (1-100)","schema":{"type":"string"},"example":"21"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":21,"source":"EOS","producers":[{"url":"https://eosusa.io/bp/eos/","name":"ivote4eosusa","rank":1,"location":840,"vote_pct":4.1754,"is_active":true,"total_votes":3.626668481694804e+20,"unpaid_blocks":1752},{"url":"https://www.eosphere.io","name":"eosphereiobp","rank":2,"location":36,"vote_pct":4.1533,"is_active":true,"total_votes":3.6074867295984733e+20,"unpaid_blocks":4932},{"url":"https://eossupport.io","name":"eossupportbp","rank":3,"location":840,"vote_pct":4.0932,"is_active":true,"total_votes":3.5553495559334114e+20,"unpaid_blocks":4152},{"url":"https://eostitan.com","name":"eostitanprod","rank":4,"location":0,"vote_pct":4.074,"is_active":true,"total_votes":3.538668935977051e+20,"unpaid_blocks":2098},{"url":"https://eos.big.one","name":"big.one","rank":5,"location":392,"vote_pct":4.0506,"is_active":true,"total_votes":3.5182935546401325e+20,"unpaid_blocks":3270},{"url":"https://newpool.io","name":"newdex.bp","rank":6,"location":392,"vote_pct":4.0485,"is_active":true,"total_votes":3.5164910207486e+20,"unpaid_blocks":2187},{"url":"https://binance-eos.com","name":"binancestake","rank":7,"location":136,"vote_pct":3.982,"is_active":true,"total_votes":3.458762308738064e+20,"unpaid_blocks":5327},{"url":"starteos.io","name":"starteosiobp","rank":8,"location":101,"vote_pct":3.9609,"is_active":true,"total_votes":3.440371034090553e+20,"unpaid_blocks":2088},{"url":"https://eosnation.io","name":"eosnationftw","rank":9,"location":124,"vote_pct":3.9518,"is_active":true,"total_votes":3.43248044684789e+20,"unpaid_blocks":216},{"url":"https://www.alohaeos.com/","name":"alohaeosprod","rank":10,"location":840,"vote_pct":3.8647,"is_active":true,"total_votes":3.3568365050750095e+20,"unpaid_blocks":7788},{"url":"https://eosio.sg","name":"eosiosg11111","rank":11,"location":702,"vote_pct":3.8582,"is_active":true,"total_votes":3.3511694411353516e+20,"unpaid_blocks":2244},{"url":"slowmist.io","name":"slowmistiobp","rank":12,"location":101,"vote_pct":3.8433,"is_active":true,"total_votes":3.338279175619627e+20,"unpaid_blocks":3516},{"url":"https://defibox.io","name":"bp.defi","rank":13,"location":392,"vote_pct":3.8287,"is_active":true,"total_votes":3.325592554691841e+20,"unpaid_blocks":1368},{"url":"https://www.bitmars.one","name":"eosflytomars","rank":14,"location":392,"vote_pct":3.6894,"is_active":true,"total_votes":3.204566796436739e+20,"unpaid_blocks":2148},{"url":"https://detroitledger.tech","name":"eosiodetroit","rank":15,"location":840,"vote_pct":3.6212,"is_active":true,"total_votes":3.145328961232925e+20,"unpaid_blocks":4666},{"url":"https://eosrio.io","name":"eosriobrazil","rank":16,"location":76,"vote_pct":3.6103,"is_active":true,"total_votes":3.1358469684173695e+20,"unpaid_blocks":2244},{"url":"https://cryptolions.io","name":"cryptolions1","rank":17,"location":804,"vote_pct":3.26,"is_active":true,"total_votes":2.8315976061353758e+20,"unpaid_blocks":7767},{"url":"https://1dex.com","name":"bp.1dex","rank":18,"location":702,"vote_pct":3.224,"is_active":true,"total_votes":2.8002893840890492e+20,"unpaid_blocks":3084},{"url":"https://eoseyes.com","name":"eoseyes.com","rank":19,"location":392,"vote_pct":2.9642,"is_active":true,"total_votes":2.5746471407236206e+20,"unpaid_blocks":3407},{"name":"eosasia11111","rank":20,"location":0,"vote_pct":2.7867,"is_active":true,"total_votes":2.420500754036844e+20,"unpaid_blocks":3213},{"url":"https://metahub-ai.com","name":"metahubeosbp","rank":21,"location":0,"vote_pct":2.4796,"is_active":true,"total_votes":2.1537522253044672e+20,"unpaid_blocks":1836}],"total_vote_weight":8.685891216912958e+21},"meta":{"timestamp":"2026-06-10T14:00:01.997Z","request_id":"4576d796-0dac-404e-8fe9-3efb6e974104"},"status":"ok","message":"Producers 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/token":{"get":{"operationId":"get_v1_token","tags":["Token"],"summary":"An account balance of any EOS token","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"EOS account name","schema":{"type":"string"},"example":"binancecleos"},{"name":"symbol","in":"query","required":false,"description":"Token symbol","schema":{"type":"string"},"example":"EOS"},{"name":"contract","in":"query","required":false,"description":"Token contract account","schema":{"type":"string"},"example":"eosio.token"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"EOS","symbol":"EOS","account":"binancecleos","balance":0.2628,"contract":"eosio.token","holds_token":true},"meta":{"timestamp":"2026-06-10T14:00:03.212Z","request_id":"0341c72c-9893-40cc-b788-d9dbaf97035f"},"status":"ok","message":"Token balance 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"EOS chain API via a public node (eos.greymass.com, live)","service":"eos-api","endpoints":{"GET /v1/info":"Live chain head, irreversible block and current producer.","GET /v1/meta":"This document.","GET /v1/token":"An account's balance of any EOS token (name=binancecleos, symbol=EOS, contract=eosio.token).","GET /v1/account":"An account's balance, staked CPU/NET, RAM and resource limits (name=binancecleos).","GET /v1/producers":"Block producers ranked by DPoS vote weight (limit=21)."},"description":"Live on-chain data from the EOS network (EOS), a delegated-proof-of-stake blockchain with a resource model where accounts stake EOS for CPU and network bandwidth and buy RAM for state, via a public EOS node. The account endpoint returns an account's liquid EOS balance, EOS staked for CPU and network, RAM quota and usage and live resource limits; the producers endpoint returns the block producers ranked by DPoS vote weight; the info endpoint returns the head and last irreversible block and current producer; the token endpoint returns an account's balance of any EOS token. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, Filecoin and EVM on-chain APIs and from price feeds — this is EOS's own account state, CPU/NET/RAM resource model and DPoS block-producer set.","head_block_num":503585211,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:00:03.496Z","request_id":"303b142a-70db-46ca-8a37-202b3657b310"},"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":9000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":138000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":888000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5600,"monthly_call_quota":4640000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/eos-api"}