{"openapi":"3.1.0","info":{"title":"MultiversX API","version":"1.0.0","description":"Live on-chain data from the MultiversX network (EGLD), a high-throughput Layer 1 built on adaptive state sharding, via its public REST API. MultiversX has three execution shards plus a metachain and a native fungible-token standard, ESDT. Resolve an address's EGLD balance, its nonce, the shard it lives on, its human-readable herotag username if it has one, and the contract that owns it. Read the ESDT tokens an account holds, each decimal-adjusted with its identifier, ticker and name. Get EGLD's live monetary picture — total and circulating supply, the amount staked and the staking ratio, the price and market cap, and the staking APR. Read the live chain state — the shard count, total blocks, accounts and transactions, the current epoch and the round refresh rate. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Hedera, Kaspa, Cosmos, Sui, NEAR, Solana and EVM on-chain APIs and from price feeds — this is MultiversX account state, ESDT holdings, EGLD economics and sharded chain stats. Perfect for wallets, explorers and analytics apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/multiversx-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Network"}],"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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"Account EGLD balance + herotag","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"MultiversX address (erd1…)","schema":{"type":"string"},"example":"erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"nonce":216,"shard":0,"source":"MultiversX","address":"erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p","balance_raw":"3512650228333772454782933","balance_egld":3512650.228334,"is_smart_contract":false,"developer_reward_egld":0},"meta":{"timestamp":"2026-06-10T14:02:20.099Z","request_id":"20f64bcb-ea57-4ad7-bf8a-5bc0b9ec2720"},"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/tokens":{"get":{"operationId":"get_v1_tokens","tags":["Account"],"summary":"ESDT tokens an account holds","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"MultiversX address (erd1…)","schema":{"type":"string"},"example":"erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"source":"MultiversX","tokens":[{"name":"Aerovek","ticker":"AERO","balance":1,"decimals":18,"identifier":"AERO-458bbf","balance_raw":"1000000000000000000"},{"name":"AmyCoin","ticker":"AMY-a74e63","balance":1,"decimals":6,"identifier":"AMY-a74e63","balance_raw":"1000000"},{"name":"Blok","ticker":"BLK-62896c","balance":1000000,"decimals":6,"identifier":"BLK-62896c","balance_raw":"1000000000000"},{"name":"BOB","ticker":"BOB-5fc887","balance":9810000000,"decimals":18,"identifier":"BOB-5fc887","balance_raw":"9810000000000000000000000000"},{"name":"WrappedBUSD","ticker":"BUSD","balance":0.00376541,"decimals":18,"identifier":"BUSD-40b57e","balance_raw":"3765406543230234"},{"name":"TheCryptoGymNetwork","ticker":"CGN-61adcd","balance":2500,"decimals":6,"identifier":"CGN-61adcd","balance_raw":"2500000000"},{"name":"GoChargeTech","ticker":"CHARGED","balance":0,"decimals":18,"identifier":"CHARGED-703583","balance_raw":"62"},{"name":"Jesus","ticker":"CHRIST-10a79b","balance":1.0e-6,"decimals":9,"identifier":"CHRIST-10a79b","balance_raw":"1000"},{"name":"Caviar","ticker":"CVR-3f4ef0","balance":100,"decimals":7,"identifier":"CVR-3f4ef0","balance_raw":"1000000000"},{"name":"DCA1USD","ticker":"DCA1USD-efe421","balance":1,"decimals":18,"identifier":"DCA1USD-efe421","balance_raw":"1000000000000000000"},{"name":"DoctorX","ticker":"DRX","balance":24029.87,"decimals":6,"identifier":"DRX-b7f337","balance_raw":"24029870000"},{"name":"ElrondFootball","ticker":"EFOO","balance":1,"decimals":18,"identifier":"EFOO-8fe2d4","balance_raw":"1000000000000000000"},{"name":"EGLDino","ticker":"EGLDI-6c86da","balance":20000000,"decimals":18,"identifier":"EGLDI-6c86da","balance_raw":"20000000000000000000000000"},{"name":"GUM","ticker":"GUM","balance":111,"decimals":18,"identifier":"GUM-849f38","balance_raw":"111000000000000000000"},{"name":"HYPE","ticker":"HYPE","balance":1000,"decimals":18,"identifier":"HYPE-619661","balance_raw":"1000000000000000000000"},{"name":"JEX","ticker":"JEX","balance":6.00087917,"decimals":18,"identifier":"JEX-9040ca","balance_raw":"6000879171951924703"},{"name":"Kavarii","ticker":"KVRI","balance":0.00835616,"decimals":18,"identifier":"KVRI-743439","balance_raw":"8356164383561640"},{"name":"LendedWrappedToken","ticker":"LWT-a13e2a","balance":10,"decimals":8,"identifier":"LWT-a13e2a","balance_raw":"1000000000"},{"name":"OfficialMINCU","ticker":"MINCU","balance":200,"decimals":18,"identifier":"MINCU-38e93d","balance_raw":"200000000000000000000"},{"name":"RARE","ticker":"RARE","balance":1,"decimals":18,"identifier":"RARE-99e8b0","balance_raw":"1000000000000000000"},{"name":"holoride","ticker":"RIDE","balance":1,"decimals":18,"identifier":"RIDE-7d18e9","balance_raw":"1000000000000000000"},{"name":"Sith","ticker":"SITH-f46426","balance":100000000,"decimals":18,"identifier":"SITH-f46426","balance_raw":"100000000000000000000000000"},{"name":"TomBet","ticker":"TOM-fa164a","balance":7,"decimals":6,"identifier":"TOM-fa164a","balance_raw":"7000000"},{"name":"ShibaX","ticker":"XSHIB","balance":0.95845215,"decimals":18,"identifier":"XSHIB-159fa8","balance_raw":"958452154876548542"},{"name":"Xtime","ticker":"XTM","balance":1.9,"decimals":18,"identifier":"XTM-67829d","balance_raw":"1900000000000000000"}],"address":"erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p","token_count":25},"meta":{"timestamp":"2026-06-10T14:02:20.351Z","request_id":"5ebd1870-fe56-42f8-9af5-f6043646cb21"},"status":"ok","message":"Tokens 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/economics":{"get":{"operationId":"get_v1_economics","tags":["Network"],"summary":"EGLD supply, staking and price","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"MultiversX","apr_pct":8.7413,"price_usd":2.91,"staked_egld":14466410,"base_apr_pct":10.6829,"topup_apr_pct":6.3317,"market_cap_usd":87627148,"staked_ratio_pct":48.0413,"total_supply_egld":30112422,"circulating_supply_egld":30112422},"meta":{"timestamp":"2026-06-10T14:02:20.473Z","request_id":"5a049f19-db8c-44da-979a-23584b1187a7"},"status":"ok","message":"Economics 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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live sharded chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"epoch":2140,"blocks":123207271,"shards":3,"source":"MultiversX","accounts":9210158,"transactions":609565167,"rounds_passed":12277,"refresh_rate_ms":6000,"rounds_per_epoch":14400,"smart_contract_results":418173278},"meta":{"timestamp":"2026-06-10T14:02:20.606Z","request_id":"7e286613-e566-4d5e-891c-c9b70bfa3aad"},"status":"ok","message":"Network state 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1200,"monthly_call_quota":138000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3700,"monthly_call_quota":860000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8400,"monthly_call_quota":4550000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/multiversx-api"}