{"openapi":"3.1.0","info":{"title":"Cardano Stake Pool API","version":"1.0.0","description":"Cardano's stake-pool operators (SPOs) — live from the public Koios indexer, no key. Cardano is delegated proof-of-stake: ADA holders delegate to stake pools run by independent operators, who mint blocks and earn rewards. The Cardano account reader resolves which pool a single stake account delegates to, but there is no registry of the pools themselves. This opens it. List every pool the chain knows with its operator margin, fixed cost and pledge; look up one pool in full — its registered identity (ticker, name, homepage, description) from off-chain metadata plus its on-chain economics: live delegated stake, saturation, delegator count, lifetime blocks and status; and read a pool's Mark / Set / Go stake snapshots, the three-epoch pipeline Cardano uses to compute rewards. The operator layer for Cardano wallets, staking dashboards, pool explorers and analytics. Distinct from the Cardano account reader (per-account delegation), the chain-economics reader, the native-token registry and the DRep governance reader. Live from the indexer; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cardanopools-api","description":"oanor gateway"}],"tags":[{"name":"Pools"},{"name":"Pool"},{"name":"Snapshot"},{"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/pools":{"get":{"operationId":"get_v1_pools","tags":["Pools"],"summary":"List the stake-pool registry","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"25"},{"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 stake-pool (SPO) registry — every pool the chain knows, each with its operator margin (%), fixed cost and pledge (in ADA) and the epoch it became active. Cardano is delegated proof-of-stake; ADA holders delegate to these pools. Paginate with limit & offset; look up one in /v1/pool.","count":25,"pools":[{"pool_id":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","meta_url":"https://raw.githubusercontent.com/Octalus/cardano/master/p.json","margin_pct":0.8999999999999999,"pledge_ada":50000,"pool_id_hex":"153806dbcd134ddee69a8c5204e38ac80448f62342f8c23cfe4b7edf","fixed_cost_ada":340,"active_epoch_no":589},{"pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","meta_url":"https://stakenuts.com/mainnet.json","margin_pct":4.9,"pledge_ada":250000,"pool_id_hex":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","fixed_cost_ada":340,"active_epoch_no":411},{"pool_id":"pool1c8k78ny3xvsfgenhf4yzvpzwgzxmz0t0um0h2xnn2q83vjdr5dj","meta_url":"https://metadata.zenithpool.io","margin_pct":0,"pledge_ada":50100,"pool_id_hex":"c1ede3cc9133209466774d4826044e408db13d6fe6df751a73500f16","fixed_cost_ada":340,"active_epoch_no":276},{"pool_id":"pool1q80jjs53w0fx836n8g38gtdwr8ck5zre3da90peuxn84sj3cu0r","meta_url":"https://ispool.live/poolMetaData.json","margin_pct":0,"pledge_ada":2000,"pool_id_hex":"01df29429173d263c7533a22742dae19f16a08798b7a57873c34cf58","fixed_cost_ada":340,"active_epoch_no":617},{"pool_id":"pool1ddskftmsscw92d7vnj89pldwx5feegkgcmamgt5t0e4lkd7mdp8","meta_url":"https://pool.adascan.net/meta/v1/poolmeta.json","margin_pct":5,"pledge_ada":7149,"pool_id_hex":"6b6164af70861c5537cc9c8e50fdae35139ca2c8c6fbb42e8b7e6bfb","fixed_cost_ada":340,"active_epoch_no":217},{"pool_id":"pool1qqqqqdk4zhsjuxxd8jyvwncf5eucfskz0xjjj64fdmlgj735lr9","meta_url":"https://stakepool.at/atada.metadata3.json","margin_pct":1,"pledge_ada":1300000,"pool_id_hex":"00000036d515e12e18cd3c88c74f09a67984c2c279a5296aa96efe89","fixed_cost_ada":340,"active_epoch_no":463},{"pool_id":"pool1dmqzwuql5mylffvn7ln3pr9j7kh4gdsssrmma5wgx56f6rtyf42","meta_url":"https://tinyurl.com/y3aryqrz","margin_pct":3,"pledge_ada":1000000,"pool_id_hex":"6ec027701fa6c9f4a593f7e7108cb2f5af54361080f7bed1c835349d","fixed_cost_ada":170,"active_epoch_no":462},{"pool_id":"pool13gdtqme63jprkug3j4wzslhmu0yk4kdx323rtxpjuz7rqv3yyes","meta_url":"http://dezent.online/deznt.metadata.json","margin_pct":3.5999999999999996,"pledge_ada":168000,"pool_id_hex":"8a1ab06f3a8c823b7111955c287efbe3c96ad9a68aa2359832e0bc30","fixed_cost_ada":340,"active_epoch_no":211},{"pool_id":"pool1qzlw7z5mutmd39ldyjnp8n650weqe55z5p8dl3fagac3ge0nx8l","meta_url":"https://cardanostakehouse.com/be8fc51e-cd0d-440f-b385-11a.json","margin_pct":2,"pledge_ada":10000,"pool_id_hex":"00beef0a9be2f6d897ed24a613cf547bb20cd282a04edfc53d477114","fixed_cost_ada":340,"active_epoch_no":419},{"pool_id":"pool16tcjctesjnks0p8sfrlf8f3d3vrp2fdn2msy80sgg3cdjtayu3z","meta_url":"https://tap-ada.github.io/poolmeta.json","margin_pct":1,"pledge_ada":5,"pool_id_hex":"d2f12c2f3094ed0784f048fe93a62d8b061525b356e043be084470d9","fixed_cost_ada":340,"active_epoch_no":419},{"pool_id":"pool1qzlwlpcsgflr9z3f24fg836tyq45p0kf5cnrp20s8v0psp6tdkx","meta_url":"https://cardanostakehouse.com/43d70337-06d3-4cac-bb57-0ab.json","margin_pct":2,"pledge_ada":10000,"pool_id_hex":"00beef8710427e328a29555283c74b202b40bec9a62630a9f03b1e18","fixed_cost_ada":340,"active_epoch_no":512},{"pool_id":"pool1p9sda64t6l9802tsu2fj6phvt9xfqgcpjucyr3kek8wzurmn8rz","meta_url":"https://k8s-pool.subnet.dev/pool-metadata/pool.json","margin_pct":0,"pledge_ada":200000,"pool_id_hex":"0960deeaabd7ca77a970e2932d06ec594c902301973041c6d9b1dc2e","fixed_cost_ada":340,"active_epoch_no":580},{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","meta_url":"https://cardanobay.com/metadata.json","margin_pct":1.2,"pledge_ada":312000,"pool_id_hex":"2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1","fixed_cost_ada":340,"active_epoch_no":212},{"pool_id":"pool18xykgvvvxej2e5ap04ks72d8fdke4qsqeh30satznyrtj88634d","meta_url":"https://teqwyse.com/tqws_pool.metadata.json","margin_pct":0,"pledge_ada":1015000,"pool_id_hex":"398964318c3664acd3a17d6d0f29a74b6d9a8200cde2f875629906b9","fixed_cost_ada":340,"active_epoch_no":236},{"pool_id":"pool1qqq6qqa0hpzvumv5p87ynczfmdj557xuwlc3289ke42g72z7f74","meta_url":"https://ahlnet.nu/pool/ahl-meta2.json","margin_pct":1,"pledge_ada":400000,"pool_id_hex":"0001a003afb844ce6d9409fc49e049db654a78dc77f1151cb6cd548f","fixed_cost_ada":380,"active_epoch_no":588},{"pool_id":"pool1e556526sqwugxwnmeumt9lhj5jukklg8vv3ynk75xt9vs7adr5y","meta_url":"http://meta.cheapstaking.com/cheap/meta.json","margin_pct":0.8999999999999999,"pledge_ada":500000,"pool_id_hex":"cd29aa2b5003b8833a7bcf36b2fef2a4b96b7d07632249dbd432cac8","fixed_cost_ada":500,"active_epoch_no":273},{"pool_id":"pool124lm97s6f4satl7xz0ulzgg6tv30tskry3zcntwrz68n60v5yne","meta_url":"https://cardanosharp.com/poolmeta.json","margin_pct":3.5000000000000004,"pledge_ada":100000,"pool_id_hex":"557fb2fa1a4d61d5ffc613f9f1211a5b22f5c2c3244589adc3168f3d","fixed_cost_ada":340,"active_epoch_no":449},{"pool_id":"pool1qqq6qzgsa8n2uvy7pusk4fnxnwd8zx7xylycednw3ugmqxk9mps","meta_url":"https://ahlnet.nu/pool/net-meta0.json","margin_pct":1.7999999999999998,"pledge_ada":0,"pool_id_hex":"0001a00910e9e6ae309e0f216aa6669b9a711bc627c98cb66e8f11b0","fixed_cost_ada":475,"active_epoch_no":215},{"pool_id":"pool1vx9tzlkgafernd9vpjpxkenutx2gncj4yn88fpq69823qlwcqrt","meta_url":"https://cardanians.io/_storage/pool-crdns.json","margin_pct":2,"pledge_ada":200000,"pool_id_hex":"618ab17ec8ea7239b4ac0c826b667c599489e25524ce74841a29d510","fixed_cost_ada":340,"active_epoch_no":383},{"pool_id":"pool13qzk5az6sx77lk2nt8zruu0t2tsyepu9q73yaz8l8j3uqxqh9wh","meta_url":"https://masp-pool.nl/MASP.json","margin_pct":1,"pledge_ada":75000,"pool_id_hex":"88056a745a81bdefd95359c43e71eb52e04c878507a24e88ff3ca3c0","fixed_cost_ada":340,"active_epoch_no":246},{"pool_id":"pool1m83drqwlugdt9jn7jkz8hx3pne53acfkd539d9cj8yr92dr4k9y","meta_url":"https://raw.githubusercontent.com/GS1973/BK/main/BKINDMN.json","margin_pct":1,"pledge_ada":5000,"pool_id_hex":"d9e2d181dfe21ab2ca7e95847b9a219e691ee1366d22569712390655","fixed_cost_ada":330,"active_epoch_no":632},{"pool_id":"pool1krznhwu3h5pu2stuslr53z5rme50t6384macsmylcnljwc7yjky","meta_url":"https://raw.githubusercontent.com/leaf-pool/md/master/m04.json","margin_pct":1,"pledge_ada":150000,"pool_id_hex":"b0c53bbb91bd03c5417c87c7488a83de68f5ea27aefb886c9fc4ff27","fixed_cost_ada":170,"active_epoch_no":511},{"pool_id":"pool1v4wgyctxyxlcf90qtgflznv5f4fcm6cy0z80mchctekt20d3cww","meta_url":"https://github.com/CardanoProxy/CPX/raw/master/cardanoproxy.json","margin_pct":1,"pledge_ada":305000,"pool_id_hex":"655c82616621bf8495e05a13f14d944d538deb04788efde2f85e6cb5","fixed_cost_ada":340,"active_epoch_no":210},{"pool_id":"pool12584mjtgz3fhgpx823qht56gycnfnezg6aqqthazv4qdxkd5c46","meta_url":"https://dolcapool.eu/dolca.metadata.json","margin_pct":2,"pledge_ada":50000,"pool_id_hex":"550f5dc96814537404c7544175d348262699e448d74005dfa26540d3","fixed_cost_ada":170,"active_epoch_no":448},{"pool_id":"pool1jhzf2mm6zdlhl6w89uhgx8nq8p6ykcc86qq58vjy0ejyxrrksfj","meta_url":"https://data.pooltool.io/md/a97ba54f-faa1-4bec-a4cf-92bfe34fe063","margin_pct":3,"pledge_ada":10,"pool_id_hex":"95c4956f7a137f7fe9c72f2e831e6038744b6307d00143b2447e6443","fixed_cost_ada":340,"active_epoch_no":633}],"offset":0,"source":"Koios"},"meta":{"timestamp":"2026-06-14T17:04:18.400Z","request_id":"b1e7b2ca-2c2c-43b8-ac5a-2e6726345fe6"},"status":"ok","message":"Pools 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":"One pool in full: identity + live economics","description":"","parameters":[{"name":"pool_id","in":"query","required":false,"description":"Pool id (pool1...); omit for the first pool","schema":{"type":"string"},"example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"OctasPool","note":"One stake pool in full: its registered identity (ticker, name, homepage) from off-chain metadata, plus on-chain economics — margin, fixed cost, pledge, live delegated stake, saturation, delegator count, lifetime blocks and status. Omit pool_id to use the first pool.","source":"Koios","ticker":"OCTAS","pool_id":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","homepage":"https://octaluso.dyndns.org","meta_url":"https://raw.githubusercontent.com/Octalus/cardano/master/p.json","margin_pct":0.8999999999999999,"pledge_ada":50000,"block_count":22896,"description":"Octa's Performance Pool","pool_id_hex":"153806dbcd134ddee69a8c5204e38ac80448f62342f8c23cfe4b7edf","pool_status":"registered","reward_addr":"stake1uy89kzrdlpaz5rzu8x95r4qnlpqhd3f8mf09edjp73vcs3qhktrtm","delegated_drep":"drep1y2t4hsu6zk98407q4ymj5jnm2d52rh76dv6whl88r9dts4qayakaf","fixed_cost_ada":340,"live_stake_ada":59396323.83871,"active_epoch_no":589,"live_delegators":5111,"live_saturation_pct":76.75},"meta":{"timestamp":"2026-06-14T17:04:22.318Z","request_id":"099b4417-1680-4abb-ab58-cf269911e03c"},"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/snapshot":{"get":{"operationId":"get_v1_snapshot","tags":["Snapshot"],"summary":"A pool's Mark/Set/Go stake snapshots","description":"","parameters":[{"name":"pool_id","in":"query","required":false,"description":"Pool id (pool1...); omit for the first pool","schema":{"type":"string"},"example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A pool's stake snapshots at the Mark / Set / Go epoch boundaries — the three-epoch pipeline Cardano uses to compute rewards. Each carries the pool's own stake and the network's total active stake (in ADA) for that snapshot. Omit pool_id to use the first pool.","count":3,"source":"Koios","pool_id":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","snapshots":[{"epoch_no":638,"snapshot":"Mark","pool_stake_ada":59384728.380198,"active_stake_ada":21614280068.786568},{"epoch_no":637,"snapshot":"Set","pool_stake_ada":59374153.627664,"active_stake_ada":21609933343.537888},{"epoch_no":636,"snapshot":"Go","pool_stake_ada":60005662.160775,"active_stake_ada":21726240807.056576}]},"meta":{"timestamp":"2026-06-14T17:04:22.507Z","request_id":"1edbe9c1-3b2d-4deb-9eec-3ecb354532cb"},"status":"ok","message":"Pool stake snapshot 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":{"first_pool":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt"},"source":"public Koios API (api.koios.rest), keyless","service":"cardanopools-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/pool":"One pool in full: ticker/name plus live stake, saturation, delegators (pool_id; omit for the first).","GET /v1/pools":"The stake-pool registry: margin, fixed cost, pledge (limit, offset).","GET /v1/snapshot":"A pool's Mark/Set/Go stake snapshots per epoch (pool_id; omit for the first)."},"description":"Read Cardano's stake-pool operators (SPOs) live from the public Koios API: list the pools with margin, fixed cost and pledge, look up one pool in full with its registered identity (ticker, name, homepage) and on-chain economics (live stake, saturation, delegators, blocks), and read a pool's Mark/Set/Go stake snapshots. The operator layer for Cardano wallets, staking dashboards and pool explorers. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:04:22.812Z","request_id":"dded3bb7-4572-4e58-aebd-125b636b827e"},"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":8800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1040,"monthly_call_quota":162000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3540,"monthly_call_quota":870000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":9700,"monthly_call_quota":5600000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cardanopools-api"}