{"openapi":"3.1.0","info":{"title":"Coreum Smart-Tokens On-Chain API","version":"1.0.0","description":"Live on-chain data from Coreum (coreum-mainnet-1), a Cosmos-SDK layer-1 whose native asset-ft module gives every fungible token programmable on-chain features. Read the registry of issued smart fungible tokens (denom, issuer, on-chain supply), the full detail of any token including its programmable features (minting, burning, freezing, whitelisting), burn rate, send-commission rate and admin, the tokens issued by a given address, the staking pool with bonded ratio and validator set, the total CORE supply and the latest block. The Coreum / smart-token / programmable-asset layer for explorers, token dashboards and DeFi tooling.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/coreum-api","description":"oanor gateway"}],"tags":[{"name":"Smart Tokens"},{"name":"Staking"},{"name":"Chain"},{"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/token":{"get":{"operationId":"get_v1_token","tags":["Smart Tokens"],"summary":"Full smart-token detail with features","description":"","parameters":[{"name":"denom","in":"query","required":true,"description":"Token denom ({subunit}-{issuer})","schema":{"type":"string"},"example":"aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","token":{"uri":"https://www.instagram.com/magnetictoneofpurpose/","admin":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","denom":"aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","issuer":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","symbol":"Hoailona","subunit":"aloha22","version":1,"features":["burning","ibc","dex_unified_ref_amount_change"],"burn_rate":0.001,"precision":8,"description":"Ho'Ailona is a Native Hawai'ian (kama'aina) Owned Physical + Digital Specialty Boutique Featuring The Most Exclusive Limited Edition Hawai'ian Apparel and Art Collections.","globally_frozen":false,"send_commission_rate":0.001}},"meta":{"timestamp":"2026-06-15T02:10:18.447Z","request_id":"6abe40ee-41c6-486b-8475-3375ed22149e"},"status":"ok","message":"Smart 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/tokens":{"get":{"operationId":"get_v1_tokens","tags":["Smart Tokens"],"summary":"Registry of smart fungible tokens","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of tokens (1-200)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","count":20,"tokens":[{"denom":"tx-core1qzx9zjv0uke5fvwmjm30rlttmumrev6mzgkc48","issuer":"core1qzx9zjv0uke5fvwmjm30rlttmumrev6mzgkc48","supply":1.0e+25,"subunit":"tx"},{"denom":"xrpl11f82115a5-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":8.15527637389e+24,"subunit":"xrpl11f82115a5"},{"denom":"cheeeze-core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk","issuer":"core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk","supply":4.99e+24,"subunit":"cheeeze"},{"denom":"xrpl64430c4512-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":2.375161818e+24,"subunit":"xrpl64430c4512"},{"denom":"dex11-core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4","issuer":"core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4","supply":1.0e+24,"subunit":"dex11"},{"denom":"dex22-core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4","issuer":"core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4","supply":1.0e+24,"subunit":"dex22"},{"denom":"utoken-core1w8wcg8z7n76zg6nquuc56gtljhd6856ss9c3dy","issuer":"core1w8wcg8z7n76zg6nquuc56gtljhd6856ss9c3dy","supply":1.0e+24,"subunit":"utoken"},{"denom":"utest2-core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk","issuer":"core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk","supply":6.6e+23,"subunit":"utest2"},{"denom":"xrpl573a95c3ab-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":4.764422882236187e+23,"subunit":"xrpl573a95c3ab"},{"denom":"test1-core17puafppu0lha2ngcyw2h4680mhpyfj6k2acpfy","issuer":"core17puafppu0lha2ngcyw2h4680mhpyfj6k2acpfy","supply":3.6997011e+23,"subunit":"test1"},{"denom":"xrpl2661e5b556-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":1.78789607487909e+21,"subunit":"xrpl2661e5b556"},{"denom":"hang10-core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","issuer":"core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","supply":8.008138008122416e+20,"subunit":"hang10"},{"denom":"pfork42069-core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","issuer":"core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","supply":4.2068995731e+20,"subunit":"pfork42069"},{"denom":"realm316-core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","issuer":"core128hgt0nnt69a5wqtl3auryf37vg90c3k9rq7q6","supply":4.19958e+20,"subunit":"realm316"},{"denom":"xrpl11278ecf9e-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":4.143231812425e+20,"subunit":"xrpl11278ecf9e"},{"denom":"vertices-core1t6fs7gtt44uenujyr8rhyajtmxv0nns6hrs72m","issuer":"core1t6fs7gtt44uenujyr8rhyajtmxv0nns6hrs72m","supply":3.69e+20,"subunit":"vertices"},{"denom":"xrpl570c00a604-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":2.5878117e+19,"subunit":"xrpl570c00a604"},{"denom":"celym-core1dhq7chjms2kmyyuw2y79kzjdl8z3px8zwkm24r","issuer":"core1dhq7chjms2kmyyuw2y79kzjdl8z3px8zwkm24r","supply":1.0e+19,"subunit":"celym"},{"denom":"xrpl62a8252400-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","issuer":"core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz","supply":7193800000000000000,"subunit":"xrpl62a8252400"},{"denom":"drop17-core1q7vrzmp2da8ntg2fp64sgv7nkmr6fsalaxwk82","issuer":"core1q7vrzmp2da8ntg2fp64sgv7nkmr6fsalaxwk82","supply":1742069696969900000,"subunit":"drop17"}],"total_smart_tokens":490},"meta":{"timestamp":"2026-06-15T02:10:18.632Z","request_id":"95f85d5c-7612-4ef8-b2cd-d97ac3d7ef3e"},"status":"ok","message":"Smart 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/tokens-by-issuer":{"get":{"operationId":"get_v1_tokens_by_issuer","tags":["Smart Tokens"],"summary":"Smart tokens issued by an address","description":"","parameters":[{"name":"issuer","in":"query","required":true,"description":"Issuer core1… address","schema":{"type":"string"},"example":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq"},{"name":"limit","in":"query","required":false,"description":"Number of tokens (1-200)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","count":1,"total":1,"issuer":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","tokens":[{"uri":"https://www.instagram.com/magnetictoneofpurpose/","admin":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","denom":"aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","issuer":"core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","symbol":"Hoailona","subunit":"aloha22","version":1,"features":["burning","ibc","dex_unified_ref_amount_change"],"burn_rate":0.001,"precision":8,"description":"Ho'Ailona is a Native Hawai'ian (kama'aina) Owned Physical + Digital Specialty Boutique Featuring The Most Exclusive Limited Edition Hawai'ian Apparel and Art Collections.","globally_frozen":false,"send_commission_rate":0.001}]},"meta":{"timestamp":"2026-06-15T02:10:18.759Z","request_id":"9990d187-e5e3-488a-aacf-0b5f05f3cadc"},"status":"ok","message":"Tokens by issuer 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/staking":{"get":{"operationId":"get_v1_staking","tags":["Staking"],"summary":"Staking pool, bonded ratio & params","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","denom":"CORE","params":{"bond_denom":"ucore","max_validators":64,"unbonding_time":"604800s","min_commission_rate":"0.050000000000000000"},"bonded_ratio":0.991794,"bonded_tokens":2511782237.521431,"not_bonded_tokens":20782534.343505},"meta":{"timestamp":"2026-06-15T02:10:18.924Z","request_id":"15aeb2a5-9ddd-49eb-9216-79db01ad567a"},"status":"ok","message":"Staking 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/validators":{"get":{"operationId":"get_v1_validators","tags":["Staking"],"summary":"Bonded validator set by voting power","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of validators (1-200)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","count":20,"validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"007TX","website":"https://x.com/007TXValidator","voting_power":442646469.097159,"commission_rate":0.05,"operator_address":"corevaloper1x9hd9r7duv2gagztvvqlw94v5gy4zd9xwhqnlm"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"BRW Capital","website":"https://x.com/BRW_Solo","voting_power":208174251.245463,"commission_rate":0.05,"operator_address":"corevaloper1p2zujexcdg7vuxjkfvahnwhutqradsjfzp6r99"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"cosmosrescue","website":"https://cosmosrescue.com","voting_power":41770876.094578,"commission_rate":0.05,"operator_address":"corevaloper1xrd2petz764advyjm7ftu37jn32ueglqe7qyeg"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"ECO Stake 🌱 | REStake.app","website":"https://ecostake.com","voting_power":33680990.885818,"commission_rate":0.05,"operator_address":"corevaloper1py9v5f7e4aaka55lwtthk30scxhnqfa6agwxt8"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Allnodes","website":"https://www.allnodes.com/core","voting_power":32826751.336957,"commission_rate":0.1,"operator_address":"corevaloper1pulqspt7t3tcnvcde38hmyngj0x43y0ujsvfus"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"SOLONATIONLABS","website":"https://tx.solonation.io","voting_power":32228768.446747,"commission_rate":0.05,"operator_address":"corevaloper1gsaxrwfu5glgw764mqhc4t8f3yxg2h07rmwt0k"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Synchrotron","website":"https://twitter.com/gosynchrotron","voting_power":21342072.717725,"commission_rate":0.05,"operator_address":"corevaloper1r4k9kr6sugcj9pmvtza93eaats6qwxwck8saak"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Huobi","website":"https://www.huobi.com/","voting_power":19583751.391079,"commission_rate":0.1,"operator_address":"corevaloper1f3v67lpkha4hhruncehqzjmt6f6t2fdnua6rv9"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"COREBIT tx","website":"digitalpalm.vip","voting_power":16487472.796803,"commission_rate":0.05,"operator_address":"corevaloper18pemafvqlr7qtja22rt0kypk3wzg6yf26fqmm5"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Keyrock","website":"https://keyrock.eu","voting_power":14146399.427411,"commission_rate":0.05,"operator_address":"corevaloper19p9mc0lrlndcwejrqk0m8a4jv035prnn0q34g0"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"UNIS","voting_power":12174865.171844,"commission_rate":0.05,"operator_address":"corevaloper1qmu97d5vmteukukt9ct8w2jnsgmc20k42m2hvq"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Citadel.one","website":"https://citadel.one","voting_power":11923006.911273,"commission_rate":0.05,"operator_address":"corevaloper1pe5d6fkmghjrpgk7qps3nqmsnwth7ejuz7gezv"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"coreum.services","website":"www.coreum.services","voting_power":10437770.432421,"commission_rate":0.06,"operator_address":"corevaloper1p7fvyew8m8zjc5cqk7d9hpvx462vgvjnsxrzfh"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Stakecito Labs","website":"https://www.stakecito.com","voting_power":9648956.581999,"commission_rate":0.1,"operator_address":"corevaloper19kg8c9k6quujkh0sflp78n4jsp3vzdy87540mm"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Zeeve Inc.","website":"https://zeeve.io","voting_power":9019674.995235,"commission_rate":0.05,"operator_address":"corevaloper1yhr8hqys3f3jwme82weaerknvan70h9j53y5cy"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Stakewolle.com","website":"https://stakewolle.com/","voting_power":8936249.60704,"commission_rate":0.05,"operator_address":"corevaloper1fq63eks78npnsgtja8m8nvvv5qmahqxawgpafz"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Conspiracy.Tesbert","voting_power":7158780.181235,"commission_rate":0.05,"operator_address":"corevaloper1ylrpx3pf5sjqvnnhd0m9na8ewg2qu5chkcsh2j"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Ubik Capital","website":"https://www.ubik.capital/","voting_power":5776751.519544,"commission_rate":0.2,"operator_address":"corevaloper1q6mdzggk7feskx3uy90su8sqernswjpce8xjnp"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Texture Digital Transfers","voting_power":5353936.828233,"commission_rate":0.1,"operator_address":"corevaloper1puxdar2dr7stfm7gd5zx085sy020jttalppz35"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Xangle","website":"https://xangle.io","voting_power":4729387.764452,"commission_rate":0.2,"operator_address":"corevaloper1y6gd9t9qq3aa0d0g5krljmzz054mzm5nzd3xvp"}],"bonded_validators":60},"meta":{"timestamp":"2026-06-15T02:10:19.062Z","request_id":"7f6b5749-ca1f-4c05-921f-5007e0618038"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Chain"],"summary":"Latest block","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"time":"2026-06-15T02:10:17.774501357Z","chain":"coreum-mainnet-1","height":76491113,"num_txs":0,"proposer_address":"jIPfx29lVl0Mbk/8/WQ4nclRrJc="},"meta":{"timestamp":"2026-06-15T02:10:19.198Z","request_id":"63b99741-be6e-4ba1-a881-d02d4249ea4a"},"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/supply":{"get":{"operationId":"get_v1_supply","tags":["Chain"],"summary":"Total CORE supply","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","denom":"CORE","micro_denom":"ucore","total_supply":101972687379.83263,"total_supply_micro":"101972687379832629"},"meta":{"timestamp":"2026-06-15T02:10:19.329Z","request_id":"7646821d-c95f-4189-bb42-2b7a34394ae9"},"status":"ok","message":"Supply 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":"Chain metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"coreum-mainnet-1","token":"CORE","source":"Coreum public Cosmos REST/LCD, keyless (3-mirror)","network":"Coreum","decimals":6,"examples":{"token":"/v1/token?denom=aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq","tokens":"/v1/tokens?limit=20","tokens_by_issuer":"/v1/tokens-by-issuer?issuer=core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq"},"endpoints":{"/v1/block":"latest block (height, time, chain_id)","/v1/token":"full smart-token detail incl. features, burn_rate, send_commission_rate, admin (denom)","/v1/supply":"total CORE supply","/v1/tokens":"registry of issued smart fungible tokens (denom, issuer, on-chain supply; limit)","/v1/staking":"staking pool, bonded ratio and params","/v1/validators":"bonded validator set ranked by voting power (limit)","/v1/tokens-by-issuer":"smart tokens issued by an address (issuer, limit)"},"micro_denom":"ucore","cache_ttl_ms":20000},"meta":{"timestamp":"2026-06-15T02:10:19.401Z","request_id":"9db5f842-f3ea-42e4-a875-b3e3d261ceff"},"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":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1370,"monthly_call_quota":62000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3970,"monthly_call_quota":240000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8630,"monthly_call_quota":920000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/coreum-api"}