{"openapi":"3.1.0","info":{"title":"Cardano Native Token Registry API","version":"1.0.0","description":"Cardano native tokens, live from the public Koios API — no key, nothing cached. On Cardano every token is a \"native asset\" identified by a policy id plus an asset name, minted under a Plutus or native minting policy. The Cardano on-chain reader lists the tokens held by an account, but there is no token registry in the marketplace; this opens it. Browse the verified token registry — the curated tokens that have submitted off-chain metadata, with their ticker, decimals, description and logo. Look up a single token in full with its on-chain facts: the asset fingerprint, total supply, how many times it has been minted and burned, and when it was first created. And list every native asset minted under a given policy id — one policy can mint a single fungible token or a whole NFT collection. The token layer for Cardano wallets, DEXs, token explorers and analytics. Live from api.koios.rest.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cardanotokens-api","description":"oanor gateway"}],"tags":[{"name":"Tokens"},{"name":"Policy"},{"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":["Tokens"],"summary":"One token in full: supply, fingerprint, mint/burn counts","description":"","parameters":[{"name":"policy_id","in":"query","required":false,"description":"Minting policy id (omit for a registry token)","schema":{"type":"string"}},{"name":"asset_name","in":"query","required":false,"description":"Asset name in hex (e.g. 4d49444153)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"https://butane.dev/app/markets/details?synth=MIDAS","logo":true,"name":"MIDAS Synthetic","note":"A single Cardano native token in full: its registry metadata (ticker, decimals) plus on-chain facts — the asset fingerprint, total supply, how many times it has been minted and burned, and when it was first created. Omit policy_id for a registry token.","source":"Koios","ticker":"MIDAS","decimals":9,"policy_id":"00000000000410c2d9e01e8ec78ab1dc6bbc383fae76cbe2689beb02","asset_name":"4d49444153","burn_count":212,"mint_count":278,"description":"Midas (MIDAS) is a synthetic asset on the Butane protocol that tracks a weighted basket of PAXG and XAUT, providing seamless exposure to their combined market value.","fingerprint":"asset17nkk7q20qefetcu4er9l0pt4jlmnarfz2ccwa4","total_supply":"16262396157","creation_time":1740418471},"meta":{"timestamp":"2026-06-14T17:04:25.762Z","request_id":"05680a07-ac1d-45df-b20c-a9d086068b23"},"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/tokens":{"get":{"operationId":"get_v1_tokens","tags":["Tokens"],"summary":"The verified token registry: ticker, decimals, description, logo","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Cardano verified token registry — native tokens that have submitted curated off-chain metadata (ticker, decimals, description, logo). Each is identified by policy_id + asset_name (hex). Paginate with limit & offset.","count":20,"offset":0,"source":"Koios","tokens":[{"url":"https://butane.dev/app/markets/details?synth=MIDAS","logo":true,"name":"MIDAS Synthetic","ticker":"MIDAS","decimals":9,"policy_id":"00000000000410c2d9e01e8ec78ab1dc6bbc383fae76cbe2689beb02","asset_name":"4d49444153","description":"Midas (MIDAS) is a synthetic asset on the Butane protocol that tracks a weighted basket of PAXG and XAUT, providing seamless exposure to their combined market value."},{"url":"https://fivebinaries.com/nutcoin","logo":true,"name":"nutcoin","ticker":"NUT","decimals":0,"policy_id":"00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae","asset_name":"6e7574636f696e","description":"The legendary Nutcoin, the first native asset minted on Cardano."},{"url":"https://github.com/incremental-series/cardano-incy","logo":true,"name":"Incy","ticker":"INCY","decimals":6,"policy_id":"0000001c1f5134859ee40556e75834b9929d1b393ab94858a3d27ae0","asset_name":"494e4359","description":"An incremental-series token."},{"logo":true,"name":"Chad","ticker":"CHAD","decimals":0,"policy_id":"0002b854b7b086fc6c2f9bd37347214f637f59f6bbd73f6f839036e0","asset_name":"43484144","description":"In God We Trust.  Real Chads love Jesus Christ."},{"logo":true,"name":"SOLANA","ticker":"SOL","decimals":0,"policy_id":"000d5e595f97381e7b624f48bff438872377f8f599a19109b963ba52","asset_name":"534f4c414e41","description":"WHAT IF SOLANA BECOMES THE NUMER ONE MEME ON CARDANO"},{"url":"https://www.hodlerstaking.com/","logo":true,"name":"Hodler Coalition Coin","ticker":"HODLR","decimals":4,"policy_id":"00109530994ea381c0bfe0936c85ea01bfe2765c24ef6dad5740c33e","asset_name":"486f646c657220436f616c6974696f6e20436f696e","description":"Stake ₳DA with the Hodler Coalition. Save the World."},{"url":"https://www.cardanoark.com/","logo":false,"name":"Cardano Ark Token","ticker":"CARK","decimals":0,"policy_id":"0011fbab202151eca9e9ef7680569d9419d12e51e693cb05a2edd2ed","asset_name":"4341524b","description":"Utility token for the Cardano Ark"},{"logo":false,"name":"Liqwid SNEK Batch","ticker":"SNEKBATCH","decimals":0,"policy_id":"0038197523fec817d355deeb2d65dd73c82fd8af4d0f455ad85ee777","asset_name":"","description":"Utility token for Liqwid SNEK market"},{"logo":true,"name":"SKYHO","ticker":"SKYHO","decimals":0,"policy_id":"00502f16bf0ce8a586d25583abc23d9eaf26396f299b1b21127cc18b","asset_name":"534b59484f","description":"SKYHO IS THE DEVIL"},{"logo":true,"name":"oink","ticker":"oink","decimals":4,"policy_id":"0072726711e64747dfe7c746fef21bf2fe9a4476d8ba65f30d30ab59","asset_name":"6f696e6b","description":"PIGS CAN FLY \n\nlets bring home the bacon\n\nOINK OINK\n"},{"url":"https://pockettowne.io","logo":true,"name":"Pocket Change","ticker":"PTC","decimals":0,"policy_id":"007394e3117755fbb0558b93c54ce3bc6c85770920044ade143dc742","asset_name":"505443","description":"Official currency of Pocket Towne"},{"logo":true,"name":"SNEKWIFBALLZ","ticker":"SNEKBALLZ","decimals":0,"policy_id":"007546fc85046e7d5cbbd2cdffae752d941135af3219738a7f6df867","asset_name":"534e454b57494642414c4c5a","description":"WE HAVE BIGGER BALLZ THAN SNEK THATS ALL"},{"url":"https://twitter.com/CATS_ada","logo":true,"name":"CATS","ticker":"CATS","decimals":0,"policy_id":"007e9f52d0f70cf6dfac65e835774c551684070c266869855b31ed04","asset_name":"43415453","description":"MEME , FUNNY"},{"url":"https://www.mayhemmob.com/","logo":true,"name":"$MYHM","ticker":"MYHM","decimals":0,"policy_id":"008977011abb1d15bbba595c0418307f4cfc7bbc707b17522db4e7c4","asset_name":"4d59484d","description":"$MYHM is an art coin that binds together art and utility in the Cardano ecosystem."},{"logo":false,"name":"Liqwid COPI Liquidation","ticker":"COPILIQ","decimals":0,"policy_id":"0092de35cf2ea8303d0d36301f4741d8d23237ebd37666810f792811","asset_name":"","description":"Utility token for Liqwid COPI market"},{"url":"https://twitter.com/adahasnoballs","logo":true,"name":"No Balls","ticker":"NOBALLS","decimals":0,"policy_id":"0097948c226173ee7cf7f116de1acf5cef496c6d93b156878415d2a6","asset_name":"4e4f42414c4c53","description":"Cardano has no balls"},{"url":"https://www.projectntl.com/","logo":true,"name":"Nautilus ","ticker":"NTL","decimals":0,"policy_id":"009f88446daf6bace9bdcb3a3ebe522d0e1fb862e2eaba0aac48f5cf","asset_name":"4e544c","description":"Native token for the Nautilus Project."},{"logo":true,"name":"SNEK WIF BLUNT","ticker":"SNEKBLUNT","decimals":0,"policy_id":"00bd05dbd23638fdb52a20296e09aff5b4534b73c9a882d81cd9a6f7","asset_name":"534e454b574946424c554e54","description":"Celebrating 4/20 on Cardano!"},{"url":"https://x.com/CharletteonCardano","logo":true,"name":"Charlett ","ticker":"Charlett","decimals":3,"policy_id":"00c8f1f71cd2a805dfda72f51298ae499f70d219d23c6b88879fa246","asset_name":"436861726c657474","description":"Hello I am Charlett the sister of Charles"},{"url":"https://midstarter.app","logo":true,"name":"MidStarterToken","ticker":"MSTART","decimals":6,"policy_id":"00d0f59eb1f4f37edf14b30abb0f59e11c7faa9be4e7cba23de08fa9","asset_name":"4d5354415254","description":"The utility token of the MidStarter ecosystem."}]},"meta":{"timestamp":"2026-06-14T17:04:26.796Z","request_id":"0e21dc7e-9a81-4e82-98a9-c44399a027f9"},"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/policy":{"get":{"operationId":"get_v1_policy","tags":["Policy"],"summary":"Every asset minted under a policy id","description":"","parameters":[{"name":"policy_id","in":"query","required":false,"description":"Minting policy id (omit for a registry token policy)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max assets (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every native asset minted under this policy id, with each asset's name, fingerprint and total supply. A policy can mint one token (fungible) or a whole NFT collection. Omit policy_id for a registry token's policy.","count":5,"assets":[{"name":"gov","decimals":0,"asset_name":"676f76","fingerprint":"asset1mjndvgwq7trnqwlrc8wlsnxdm2n2djeenprgak","total_supply":"0"},{"name":"p_MIDAS","decimals":0,"asset_name":"705f4d49444153","fingerprint":"asset1snjmahe5p7dyasr34wt8a6lvyh9tfsyf4qe376","total_supply":"1"},{"decimals":0,"asset_name":"","fingerprint":"asset1pc0qzgrzqrrfc56lwhcl6n996c0smaywlxvcfd","total_supply":"4"},{"name":"MIDAS","decimals":9,"asset_name":"4d49444153","fingerprint":"asset17nkk7q20qefetcu4er9l0pt4jlmnarfz2ccwa4","total_supply":"16262396157"},{"name":"STK","decimals":0,"asset_name":"53544b","fingerprint":"asset1h4rzmdnga6k2a5v79ax6m77ndzdf0zlczgdv2l","total_supply":"9"}],"source":"Koios","policy_id":"00000000000410c2d9e01e8ec78ab1dc6bbc383fae76cbe2689beb02"},"meta":{"timestamp":"2026-06-14T17:04:27.011Z","request_id":"a1ac3f03-e034-43e0-af41-273f066caa14"},"status":"ok","message":"Policy assets 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":{"sample":{"top_token":"MIDAS"},"source":"public Koios API (api.koios.rest), keyless","service":"cardanotokens-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/token":"One token in full: supply, fingerprint, mint/burn counts (policy_id, asset_name; omit for a registry token).","GET /v1/policy":"Every asset minted under a policy id (policy_id, limit; omit for a registry token's policy).","GET /v1/tokens":"The verified token registry: ticker, decimals, description, logo (limit, offset)."},"description":"Read Cardano native tokens live from the public Koios API: browse the verified token registry (ticker, decimals, description, logo), look up a single token in full with its on-chain total supply, fingerprint, mint/burn counts and creation, and list every asset minted under a policy id. The token layer for Cardano wallets, DEXs and token explorers. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:27.228Z","request_id":"c1fbbf8e-78db-4bd5-8a6b-a741fd9539e0"},"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":7300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":930,"monthly_call_quota":143500,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3260,"monthly_call_quota":785000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9550,"monthly_call_quota":5030000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cardanotokens-api"}