{"openapi":"3.1.0","info":{"title":"Cardano API","version":"1.0.0","description":"Live on-chain data from the Cardano blockchain (ADA) via the public Koios indexer. Resolve a stake account's whole state — total ADA controlled, UTxO balance, the stake pool it delegates to, its DRep governance vote, lifetime and withdrawable staking rewards, and registration status. Fetch the native tokens and NFTs a stake account holds, with policy id, decoded asset name, fingerprint and decimal-adjusted quantity. Read a stake pool's live economics — ticker, active and live stake, live saturation, margin, fixed cost, pledge, blocks minted and delegator count. Get the live chain tip and current-epoch active stake, transaction count and fees. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, EVM and Solana on-chain APIs and from price feeds — this is Cardano stake-account state, delegation, native-asset holdings, stake-pool economics and epoch health. Perfect for wallets, explorers, staking dashboards, delegation tools, NFT and analytics apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cardano-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Pool"},{"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":"Stake account state + delegation","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Cardano stake address (stake1…)","schema":{"type":"string"},"example":"stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Cardano (Koios)","status":"registered","deposit_ada":2,"stake_address":"stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg","delegated_drep":"drep_always_abstain","delegated_pool":"pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6","withdrawals_ada":68992.703144,"utxo_balance_ada":451044.763493,"total_balance_ada":459732.355168,"rewards_lifetime_ada":77616.319214,"rewards_available_ada":8687.591675},"meta":{"timestamp":"2026-06-09T20:24:36.041Z","request_id":"fbc7381e-da62-4545-b4c4-ab400051a9e8"},"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/assets":{"get":{"operationId":"get_v1_assets","tags":["Account"],"summary":"Native tokens and NFTs held","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Cardano stake address (stake1…)","schema":{"type":"string"},"example":"stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"assets":[{"decimals":0,"quantity":1,"policy_id":"1f0da9edafc57ae7a44c8864f217475e102fc8af68eb3a93eeee059b","asset_name":"HOSKYMINTKEY","fingerprint":"asset1twflravh4y3fksuuexg36yl0mzyd79emlmxq34","asset_name_hex":"484f534b594d494e544b4559"},{"decimals":0,"quantity":1,"policy_id":"41142faeb5e3c644625966715c0a844bb4d6aeef2bcdbf535b14e5a5","asset_name":"tHANDLE","fingerprint":"asset1fuwwjcwk008vpcp8ecjw7akxn4lx09sg6lstlx","asset_name_hex":"7448414e444c45"},{"decimals":6,"quantity":6618.80938,"policy_id":"869fc72c11977e4be3e8e1cc63cca008a925886332795c9601f965ca","asset_name":"USDC","fingerprint":"asset18f7zn35vthuh24ed4y6ucvmheur2wggcdfwj29","asset_name_hex":"55534443"},{"decimals":0,"quantity":1,"policy_id":"937884dda04d3dd3616fa447c7fb396e5943d19000ccf4f142320203","asset_name":"ShenRewardTicket2401","fingerprint":"asset1u3p0k7p4hfd5m8l8xyye6rvl8m88vked2sjwzt","asset_name_hex":"5368656e5265776172645469636b657432343031"},{"decimals":0,"quantity":1,"policy_id":"a5bb0e5bb275a573d744a021f9b3bff73595468e002755b447e01559","asset_name":"HOSKYCashGrab000269585","fingerprint":"asset16xewgx8myqt8zul8d36fkzhm7ancal9d2tuv09","asset_name_hex":"484f534b594361736847726162303030323639353835"},{"decimals":0,"quantity":32000000000000,"policy_id":"d132e23bb8216eb95777d03e36a09e23db861b91786f6dee5822c96c","asset_name":"AIDZ","fingerprint":"asset1hhc787ez9w7a36qsc9avs0g0hwp8ww4aphh209","asset_name_hex":"4149445a"},{"decimals":0,"quantity":1,"policy_id":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"zen0","fingerprint":"asset19wjtw5lc6djl7zqgzgvt05fvkhptvuj6pu8vej","asset_name_hex":"7a656e30"},{"decimals":0,"quantity":1,"policy_id":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"zen1","fingerprint":"asset1at5gykl5ek7mmh4waxznq55fj9w00wuss9jm9j","asset_name_hex":"7a656e31"},{"decimals":0,"quantity":1,"policy_id":"f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a","asset_name":"zen2","fingerprint":"asset1j8e6j7umur48sldscdrnfzvs8pvmd5eshgx5lz","asset_name_hex":"7a656e32"}],"source":"Cardano (Koios)","asset_count":9,"stake_address":"stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg"},"meta":{"timestamp":"2026-06-09T20:24:36.562Z","request_id":"6a5836c8-710b-46e7-9999-12e5b8b132f6"},"status":"ok","message":"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/pool":{"get":{"operationId":"get_v1_pool","tags":["Pool"],"summary":"Stake pool live economics","description":"","parameters":[{"name":"pool","in":"query","required":true,"description":"Stake pool id (pool1…)","schema":{"type":"string"},"example":"pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Kind Orange Heisenberg","source":"Cardano (Koios)","status":"registered","ticker":"KOH","pool_id":"pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6","margin_pct":5,"pledge_ada":0,"blocks_minted":19196,"fixed_cost_ada":340,"live_stake_ada":70517481.757637,"reward_address":"stake1uxyv6prv3gcvpw73udgdwuqqnh7gn6y7dfw3q9n0gjl82rq9n5mf4","live_delegators":10,"live_pledge_ada":0,"active_stake_ada":70536005.404329,"live_saturation_pct":91.15},"meta":{"timestamp":"2026-06-09T20:24:37.767Z","request_id":"55a23fb3-18df-4bbc-b594-f4bb92bddc16"},"status":"ok","message":"Pool 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 chain state + epoch","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"era":"Conway","epoch":636,"source":"Cardano (Koios)","abs_slot":189470360,"block_hash":"68b957cb76fe8738bd072daafa9f3c060642f08b0e16d7e93c098e036b3d7cd6","block_time":"2026-06-09T20:24:11.000Z","block_height":13528981,"epoch_fees_ada":125707.584202,"epoch_tx_count":25503,"epoch_block_count":3929,"epoch_active_stake_ada":21726240807.056576},"meta":{"timestamp":"2026-06-09T20:24:38.296Z","request_id":"4bf7d25e-7e07-425d-8741-1fe15a6ac6cf"},"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":1200,"monthly_call_quota":140000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3600,"monthly_call_quota":880000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8400,"monthly_call_quota":4700000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cardano-api"}