# Cardano Native Token Registry API > 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. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cardanotokens-api/..." ``` ## Pricing - **Free** (Free) — 7,300 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 143,500 calls/Mo, 9 req/s - **Pro** ($33/Mo) — 785,000 calls/Mo, 22 req/s - **Business** ($96/Mo) — 5,030,000 calls/Mo, 55 req/s ## Endpoints ### Tokens #### `GET /v1/token` — One token in full: supply, fingerprint, mint/burn counts **Parameters:** - `policy_id` (query, optional, string) — Minting policy id (omit for a registry token) - `asset_name` (query, optional, string) — Asset name in hex (e.g. 4d49444153) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cardanotokens-api/v1/token" ``` **Response:** ```json { "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 } ``` #### `GET /v1/tokens` — The verified token registry: ticker, decimals, description, logo **Parameters:** - `limit` (query, optional, string) — Page size (1-100) Example: `20` - `offset` (query, optional, string) — Offset Example: `0` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cardanotokens-api/v1/tokens?limit=20&offset=0" ``` **Response:** ```json { "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, …(truncated, see openapi.json for full schema) ``` ### Policy #### `GET /v1/policy` — Every asset minted under a policy id **Parameters:** - `policy_id` (query, optional, string) — Minting policy id (omit for a registry token policy) - `limit` (query, optional, string) — Max assets (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cardanotokens-api/v1/policy?limit=20" ``` **Response:** ```json { "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" }, { "name": null, "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", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/cardanotokens-api/v1/meta" ``` **Response:** ```json { "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 } ``` --- Marketplace page: https://www.oanor.com/api/cardanotokens-api OpenAPI spec: https://www.oanor.com/api/cardanotokens-api/openapi.json