Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nexus.gerowallet.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Epochs API provides endpoints for querying epoch information and protocol parameters on the Cardano blockchain. Epochs are 5-day periods during which stake distribution and rewards are calculated.

​
Available endpoints

Get latest epoch

Get information about the current epoch

Get epoch parameters

Retrieve protocol parameters for a specific epoch

Get latest parameters

Get protocol parameters for the current epoch

​
Epoch structure

Each Cardano epoch lasts approximately 5 days and contains:
  • 432,000 slots (1 second per slot)
  • 21,600 blocks (1 block per 20 seconds average)
  • Stake distribution snapshot
  • Rewards calculation and distribution

​
Epoch information

The latest epoch endpoint returns:
  • epoch - Epoch number
  • start_time - Unix timestamp of epoch start
  • end_time - Unix timestamp of epoch end
  • first_block_time - Timestamp of first block
  • last_block_time - Timestamp of last block
  • block_count - Number of blocks produced
  • tx_count - Number of transactions
  • output - Total output value in lovelace
  • fees - Total fees collected
  • active_stake - Total active stake
{
  "epoch": 450,
  "start_time": 1738713600,
  "end_time": 1739145600,
  "first_block_time": 1738713620,
  "last_block_time": 1739145580,
  "block_count": 21534,
  "tx_count": 456789,
  "output": "12345678901234567890",
  "fees": "123456789012",
  "active_stake": "23456789012345678901"
}

​
Protocol parameters

Protocol parameters define network rules and are updated through governance:
CategoryParameters
FeesminFeeA, minFeeB, keyDeposit, poolDeposit
LimitsmaxBlockSize, maxTxSize, maxBlockHeaderSize
StakingpoolRetireMaxEpoch, stakePoolTargetNum, poolPledgeInfluence
EconomicsmonetaryExpansion, treasuryGrowthRate
ScriptmaxTxExMem, maxTxExSteps, maxBlockExMem, maxBlockExSteps
GovernancegovActionDeposit, dRepDeposit, dRepActivity

​
Example: Get current epoch

curl -X GET "https://nexus-dev.gerowallet.io/api/epoch/latest?network=MAINNET" \
  -H "Authorization: Bearer your-token"

​
Caching

Epoch data is cached for 5 minutes to balance freshness and performance. For real-time block information, use the Blocks API instead.