Skip to main content
GET
Get all-epochs stake pool history

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.

Path Parameters

poolId
string
default:""
required

Cardano stake pool identifier (accepts both bech32 and hex formats)

Query Parameters

network
enum<string>
Available options:
CARDANO_MAINNET,
CARDANO_PREPROD,
CARDANO_PREVIEW,
APEX_PRIME_MAINNET,
APEX_VECTOR_MAINNET,
APEX_VECTOR_TESTNET,
MIDNIGHT_MAINNET,
MIDNIGHT_PREPROD,
MIDNIGHT_PREVIEW,
BITCOIN_MAINNET,
BITCOIN_TESTNET4

Response

Successfully retrieved stake pool history

margin
number
epoch_no
integer<int32>
active_stake
integer
active_stake_pct
number
saturation_pct
number
block_cnt
integer<int32>
delegator_cnt
integer<int32>
fixed_cost
integer
pool_fees
integer
deleg_rewards
integer
epoch_ros
number
{key}
any