{"openapi":"3.1.0","info":{"title":"Ergo On-Chain & Native Token API","version":"1.0.0","description":"Live on-chain data from the Ergo (ERG) blockchain via the public Ergo Platform explorer — clean JSON, no cache. Ergo is a proof-of-work cryptocurrency built on the extended-UTXO (eUTXO) model with first-class native tokens, Sigma-protocol smart contracts and storage rent — a distinctly different design from account-based chains. Read the network head (best block height, mining difficulty, miner reward); browse the most recent blocks with their miner, size, difficulty and reward; fetch a single block by header id; look up any address's confirmed ERG balance and every native token it holds; or resolve a native token's id, name, decimals, emission amount and description. Read live from Ergo, nothing stored. This is Ergo's own extended-UTXO chain, native-token and Autolykos-PoW layer — distinct from the Bitcoin, Decred, EOS, Internet Computer and other on-chain APIs and from price feeds.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ergo-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Blocks"},{"name":"Block"},{"name":"Address"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Chain head — best block, difficulty, miner reward","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"ergo","model":"extended UTXO (eUTXO)","source":"Ergo Platform","block_id":"e561e16ca01c0d19a116557b93f93c5791eceabd33ab400ce3ff3405157619bc","tx_count":4,"consensus":"Autolykos v2 PoW","best_block":1804874,"block_time":"2026-06-10T22:54:03.743Z","difficulty":101914591100928,"native_token":"ERG","total_blocks":1804874,"miner_reward_erg":3},"meta":{"timestamp":"2026-06-10T22:58:49.747Z","request_id":"db80f0c8-8950-4921-8853-46c5171ad2cb"},"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"}}}},"/v1/blocks":{"get":{"operationId":"get_v1_blocks","tags":["Blocks"],"summary":"Most recent blocks with miner, size, difficulty, reward","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of blocks (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"blocks":[{"id":"e561e16ca01c0d19a116557b93f93c5791eceabd33ab400ce3ff3405157619bc","epoch":1762,"miner":"88dhgzEuTXaRQTX5KNdnaWTTX7fEZVEQRn6qP4MJotPuRnS3QpoJxYpSaXoU1y7SHp8ZXMp92TH22DBY","height":1804874,"tx_count":4,"timestamp":"2026-06-10T22:54:03.743Z","difficulty":101914591100928,"miner_name":"2TH22DBY","size_bytes":38018,"miner_reward_erg":3},{"id":"79cb6b8946a22d48de1d981d35691dcf5d96c242a958197100534a69919ce34a","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804873,"tx_count":6,"timestamp":"2026-06-10T22:47:51.115Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":37215,"miner_reward_erg":3},{"id":"66cd716694e61fa9f8df43e8e34acccf53e860a8925f6087be94c3b3ea3cac32","epoch":1762,"miner":"88dhgzEuTXaRQTX5KNdnaWTTX7fEZVEQRn6qP4MJotPuRnS3QpoJxYpSaXoU1y7SHp8ZXMp92TH22DBY","height":1804872,"tx_count":4,"timestamp":"2026-06-10T22:47:40.260Z","difficulty":101914591100928,"miner_name":"2TH22DBY","size_bytes":19064,"miner_reward_erg":3},{"id":"ec227906ebdccd3bf942115ed2d76f477e3502cc880077544a34d9abeb7b1e40","epoch":1762,"miner":"88dhgzEuTXaRQTX5KNdnaWTTX7fEZVEQRn6qP4MJotPuRnS3QpoJxYpSaXoU1y7SHp8ZXMp92TH22DBY","height":1804871,"tx_count":3,"timestamp":"2026-06-10T22:44:27.246Z","difficulty":101914591100928,"miner_name":"2TH22DBY","size_bytes":10277,"miner_reward_erg":3},{"id":"06f0c6bc92ee49a3a58787889e7d54587542dd93759c4da1396162e40d973f35","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804870,"tx_count":21,"timestamp":"2026-06-10T22:41:54.110Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":106666,"miner_reward_erg":3},{"id":"069029944d38d3edb28140ea9bca8f6975daeec87d09de33b70af516a85a34ad","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804869,"tx_count":5,"timestamp":"2026-06-10T22:39:42.365Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":48398,"miner_reward_erg":3},{"id":"937023b9ce4a38794de00455f665e9460ffbd73a1c26664578a0462584adeb38","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804868,"tx_count":4,"timestamp":"2026-06-10T22:39:18.732Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":47149,"miner_reward_erg":3},{"id":"21c37469a7d8599e6c25f49c7a2af4f136575f1cd788e8df951508dd79ba8ee0","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804867,"tx_count":1,"timestamp":"2026-06-10T22:39:02.698Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":3627,"miner_reward_erg":3},{"id":"26b1087cc164b5ecfeb3ef3b2f74b41b1863abfbff57a205ee4c9332355fce3b","epoch":1762,"miner":"88dhgzEuTXaSuf5QC1TJDgdxqJMQEQAM6YaTTRqmUDrmPoVky1b16WAK5zMrq3p2mYqpUNKCyi5CLS9V","height":1804866,"tx_count":15,"timestamp":"2026-06-10T22:37:42.869Z","difficulty":101914591100928,"miner_name":"yi5CLS9V","size_bytes":87813,"miner_reward_erg":3},{"id":"d00243401171353b33508341c3cb6607d466c2f7389e8306d7b38916ace23625","epoch":1762,"miner":"88dhgzEuTXaRQTX5KNdnaWTTX7fEZVEQRn6qP4MJotPuRnS3QpoJxYpSaXoU1y7SHp8ZXMp92TH22DBY","height":1804865,"tx_count":16,"timestamp":"2026-06-10T22:33:42.888Z","difficulty":101914591100928,"miner_name":"2TH22DBY","size_bytes":63678,"miner_reward_erg":3}],"source":"Ergo Platform","total_blocks":1804874},"meta":{"timestamp":"2026-06-10T22:58:49.900Z","request_id":"04a294a2-c523-4cc1-b139-fb77f31a1d18"},"status":"ok","message":"Blocks 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/block":{"get":{"operationId":"get_v1_block","tags":["Block"],"summary":"A single block by header id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Block header id (64 hex)","schema":{"type":"string"},"example":"63359f6e2b35749e283540848927d3e67112c4e40e96169fd85aa0aa2967a2a2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"63359f6e2b35749e283540848927d3e67112c4e40e96169fd85aa0aa2967a2a2","height":1804626,"source":"Ergo Platform","version":4,"tx_count":5,"parent_id":"c51d8214c03a5d8313ce7c3888dcdab52ea1874bd6a64284738415fa419d74f0","timestamp":"2026-06-10T14:05:34.514Z","difficulty":110969137135616,"size_bytes":42289},"meta":{"timestamp":"2026-06-10T22:58:50.236Z","request_id":"578a696b-3e22-41a1-9bec-987f1cc70444"},"status":"ok","message":"Block 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/address":{"get":{"operationId":"get_v1_address","tags":["Address"],"summary":"An address's confirmed ERG balance and native tokens held","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Ergo address","schema":{"type":"string"},"example":"9gqhrGQN3eQmTFAW9J6KNX8ffUhe8BmTesE45b9nBmL7VJohhtY"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Ergo Platform","tokens":[{"name":"ClaimRSN.tech","amount":7105,"decimals":1,"token_id":"31ac0f72b036502a17e27ff3bc9eb1b3ae4eef9aa4a3c3bd818475d6326cbd9f"},{"name":"🚬","amount":21069420,"decimals":0,"token_id":"ebb40ecab7bb7d2a935024100806db04f44c62c33ae9756cf6fc4cb6b9aa2d12"},{"name":"ClaimRSN.tech","amount":3102,"decimals":1,"token_id":"ed2197ebb2b958670cb568aeed54693617a3f3718d16d1a298b8c8d337193da0"},{"name":"rsHOSKY","amount":69420,"decimals":0,"token_id":"6ad70cdbf928a2bdd397041a36a5c2490a35beb4d20eabb5666f004b103c7189"},{"name":"ClaimRSN.tech","amount":21025,"decimals":1,"token_id":"028ec31acacaa6aab6cd89a16cab5f9046cfea701262f8c9532ace433075353a"},{"name":"$Lambo","amount":69,"decimals":0,"token_id":"0fdb7ff8b37479b6eb7aab38d45af2cfeefabbefdc7eebc0348d25dd65bc2c91"},{"name":"COS","amount":1234321,"decimals":0,"token_id":"f0d5bdf474fcbd4249608e6dc6e9cf34a327b218f66445ea545b4c711b4676e3"}],"address":"9gqhrGQN3eQmTFAW9J6KNX8ffUhe8BmTesE45b9nBmL7VJohhtY","balance_erg":3.458269,"token_count":7,"balance_nanoerg":3458269000},"meta":{"timestamp":"2026-06-10T22:58:52.793Z","request_id":"abb73c49-eb1d-4110-9c56-4b7593618a94"},"status":"ok","message":"Address 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":"A native token's id, name, decimals, emission and description","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Token id (64 hex)","schema":{"type":"string"},"example":"03faf2cb329f2e90d6d23b58d91bbb6c046aa143261cc21f52fbe2824bfcbf04"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"SigUSD","type":"EIP-004","box_id":"a49076f75e8446fec018d5d32cddf6e05575ef1273232e680f4cd5d716f4e78b","source":"Ergo Platform","decimals":2,"token_id":"03faf2cb329f2e90d6d23b58d91bbb6c046aa143261cc21f52fbe2824bfcbf04","description":"SigmaUSD - V2","emission_amount":10000000000001},"meta":{"timestamp":"2026-06-10T22:58:52.922Z","request_id":"df9afe76-2183-40a6-ae6c-0e59cd5164a2"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"model":"extended UTXO (eUTXO)","source":"Ergo Platform explorer API (api.ergoplatform.com, live)","service":"ergo-api","consensus":"Autolykos v2 PoW","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A single block by header id (id=64 hex).","GET /v1/token":"A native token's id, name, decimals, emission and description (id=64 hex).","GET /v1/blocks":"Most recent blocks with miner, size, difficulty, reward (limit=10).","GET /v1/address":"An address's confirmed ERG balance and native tokens held (address=...).","GET /v1/network":"Chain head — best block, difficulty, miner reward."},"best_block":1804874,"description":"Live on-chain data from the Ergo (ERG) blockchain via the public Ergo Platform explorer API. Ergo is a proof-of-work cryptocurrency built on the extended-UTXO (eUTXO) model with first-class native tokens, Sigma-protocol smart contracts and storage rent. The network endpoint returns the chain head (best block, difficulty, miner reward, latest block); the blocks endpoint returns the most recent blocks with miner, size, difficulty and reward; the block endpoint returns a single block by header id; the address endpoint returns an address's confirmed ERG balance and every native token it holds; the token endpoint returns a native token's id, name, decimals, emission amount and description. Live, no key, nothing stored. Distinct from the Bitcoin, Decred, EOS, Internet Computer and other on-chain APIs and from price feeds — this is Ergo's own extended-UTXO chain, native tokens and PoW layer.","native_token":"ERG","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T22:58:53.054Z","request_id":"1a6d6e68-ce5e-4c9c-8a09-718dd36867dc"},"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":1000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1050,"monthly_call_quota":36000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2850,"monthly_call_quota":185000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6600,"monthly_call_quota":920000,"rps_limit":58,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ergo-api"}