Skip to main content
GET
List and search Cardano stake pools

Authorizations

X-Api-Key
string
header
required

API key (programmatic access — recommended)

Send your API key in the X-Api-Key header. Keys start with nxs_ and are created in the dashboard (or via POST /api/keys with a session JWT).

Each key is scoped to one chain and one network (for example CARDANO_MAINNET), fixed at creation time. It cannot query a different network on the same chain, and it cannot query a different chain at all. A mismatched network parameter returns 400 Network Mismatch. Create one key per chain and network under the same account.

This is the credential most integrations should use.

Query Parameters

network
enum<string>

Accepts either the value listed here (CARDANO_MAINNET) or its kebab-case alias (cardano-mainnet); matching is case-insensitive. Omit it and the network is taken from the API key. A value that disagrees with the key's own network returns 400 Network Mismatch.

Available options:
CARDANO_MAINNET,
CARDANO_PREPROD,
CARDANO_PREVIEW,
APEX_PRIME_MAINNET,
APEX_VECTOR_MAINNET,
APEX_VECTOR_TESTNET,
MIDNIGHT_MAINNET,
MIDNIGHT_PREPROD,
MIDNIGHT_STAGENET,
BITCOIN_MAINNET,
BITCOIN_TESTNET4

Case-insensitive match against ticker, name or bech32 pool id

sort
string
default:""

Sort field: ros (default), ticker or liveStake. Descending, nulls last.

page
string
default:""

Page number (1-based). Omit together with pageSize for the full set.

pageSize
string
default:""

Pools per page. Defaults to 100 when page is supplied.

Response

Successfully retrieved stake pools

poolIdBech32
string
poolIdHex
string
poolStatus
string
activeEpochNo
integer<int64>
retiringEpoch
integer<int64>
marginPct
number
fixedCost
integer
pledgeDeclared
integer
deposit
integer
rewardAddr
string
owners
string[]
relays
object[]
metaUrl
string
metaHash
string
metaJson
any
vrfKeyHash
string
opCertCounter
integer<int64>
blockCount
integer<int64>
blocksMinted
integer<int64>
activeStake
integer
liveStake
integer
livePledge
integer
sigma
number
liveSaturationPct
number
liveStakePct
number
liveDelegators
integer<int64>
ticker
string
poolGroup
string
name
string
homepage
string
description
string
ros
number<double>
extendedMetadata
any
{key}
any