{"openapi":"3.1.0","info":{"title":"Hedera API","version":"1.0.0","description":"Live on-chain data from the Hedera network (HBAR), the enterprise public ledger built on hashgraph consensus, via the public Hedera Mirror Node. Hedera identifies every account, token and contract by a shard.realm.num id like 0.0.2 — not a hash address — and this API speaks that native form. Resolve an account's whole state: HBAR balance, the node or account it stakes to, whether it declines rewards and its pending reward, its auto-renew and token-association settings, memo and EVM nonce. Get the HTS tokens an account holds, each decimal-adjusted with token id and freeze/KYC status. Read any HTS token's details — name, symbol, decimals, total and max supply, treasury account and whether it's a fungible token or an NFT collection. Get the live HBAR supply, released and total. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Solana and EVM on-chain APIs and from price feeds — this is Hedera account state, staking, HTS-token holdings, token details and HBAR supply. Perfect for wallets, explorers, treasury, HTS-token and analytics apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hedera-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Token"},{"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 state + staking","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Hedera account id (shard.realm.num)","schema":{"type":"string"},"example":"0.0.2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Hedera (Mirror Node)","account":"0.0.2","deleted":false,"token_count":0,"hbar_balance":16630126.37744658,"ethereum_nonce":0,"declines_reward":false,"auto_renew_period":7000000,"created_timestamp":"1605733260.898372007","pending_reward_hbar":0,"max_auto_token_associations":0},"meta":{"timestamp":"2026-06-09T20:24:30.498Z","request_id":"f7ce0b98-a611-48ec-b935-44c170196080"},"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":"HTS tokens an account holds","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Hedera account id","schema":{"type":"string"},"example":"0.0.439909"},{"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":{"source":"Hedera (Mirror Node)","tokens":[{"balance":137.128112,"decimals":6,"token_id":"0.0.456858","kyc_status":"NOT_APPLICABLE","raw_balance":137128112,"freeze_status":"UNFROZEN","auto_associated":false}],"account":"0.0.439909","token_count":1},"meta":{"timestamp":"2026-06-09T20:24:30.648Z","request_id":"986dc12f-8338-4dbd-bd80-615cb44edc4e"},"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/token":{"get":{"operationId":"get_v1_token","tags":["Token"],"summary":"HTS token details","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Hedera token id","schema":{"type":"string"},"example":"0.0.456858"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"USD Coin","type":"FUNGIBLE_COMMON","paused":false,"source":"Hedera (Mirror Node)","symbol":"USDC","decimals":6,"token_id":"0.0.456858","total_supply":450010110,"created_timestamp":"1632175205.445296000","treasury_account_id":"0.0.439909"},"meta":{"timestamp":"2026-06-09T20:24:30.783Z","request_id":"35fef966-19d1-429b-83d2-7acdbb9b9c60"},"status":"ok","message":"Token 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 HBAR supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Hedera (Mirror Node)","timestamp":"1781035276.242519677","total_supply_hbar":50000000000,"released_supply_hbar":43373517400.492935},"meta":{"timestamp":"2026-06-09T20:24:30.903Z","request_id":"0818569a-7320-44a1-a7ae-b302da499967"},"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":6000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":130000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":820000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8600,"monthly_call_quota":4500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hedera-api"}