Skip to main content
GET
Get the current Cardano protocol parameters

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

Response

Successfully retrieved latest epoch protocol parameters

minFeeA
integer<int32>
minFeeB
integer<int32>
maxBlockSize
integer<int32>
maxTxSize
integer<int32>
maxBlockHeaderSize
integer<int32>
keyDeposit
string
poolDeposit
string
a0
number
rho
number
tau
number
decentralisationParam
number
extraEntropy
string
protocolMajorVer
integer<int32>
protocolMinorVer
integer<int32>
minUtxo
string
minPoolCost
string
nonce
string
costModels
object

Plutus cost models per language, keyed by position. The key form depends on which upstream provider served the request (zero-padded "000", or plain "0"), so prefer costModelsRaw, which carries the same values as ordered arrays.

priceMem
number
priceStep
number
maxTxExMem
string
maxTxExSteps
string
maxBlockExMem
string
maxBlockExSteps
string
maxValSize
string
collateralPercent
number
maxCollateralInputs
integer<int32>
coinsPerUtxoSize
string
pvtMotionNoConfidence
number
pvtCommitteeNormal
number
pvtCommitteeNoConfidence
number
pvtHardForkInitiation
number
pvtPPSecurityGroup
number
dvtMotionNoConfidence
number
dvtCommitteeNormal
number
dvtCommitteeNoConfidence
number
dvtUpdateToConstitution
number
dvtHardForkInitiation
number
dvtPPNetworkGroup
number
dvtPPEconomicGroup
number
dvtPPTechnicalGroup
number
dvtPPGovGroup
number
dvtTreasuryWithdrawal
number
committeeMinSize
integer<int32>
committeeMaxTermLength
integer<int32>
govActionLifetime
integer<int32>
govActionDeposit
integer
drepDeposit
integer
drepActivity
integer<int32>
minFeeRefScriptCostPerByte
number
emax
integer<int32>
nopt
integer<int32>
costModelsRaw
object

Plutus cost models per language as ordered arrays — the form the node, Ogmios, Koios and transaction builders use. Pass these to any builder that computes a script integrity hash (Mesh's network parameter takes number[][]); letting a builder fall back to its own bundled cost models is a common cause of a transaction the node then rejects for a mismatched hash. Null when the upstream keys do not form a complete 0..n-1 index set, since an array in the wrong order would cause that same rejection rather than an obvious error.

{key}
any