Skip to main content
GET
Get a Cardano epoch by number

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

epochNo
string
default:""
required

Epoch number (0 for the genesis epoch)

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 epoch information

Epoch information including statistics and metrics

epoch
integer<int32>
default:""
required

Epoch number

Example:

500

startTime
integer<int64> | null
default:""

Epoch start time (Unix timestamp)

Example:

1697500800

endTime
integer<int64> | null
default:""

Epoch end time (Unix timestamp)

Example:

1697932800

firstBlockTime
integer<int64> | null
default:""

First block time in epoch (Unix timestamp)

Example:

1697500805

lastBlockTime
integer<int64> | null
default:""

Last block time in epoch (Unix timestamp)

Example:

1697932795

blockCount
integer<int32> | null
default:""

Number of blocks in epoch

Example:

21600

txCount
integer<int32> | null
default:""

Number of transactions in epoch

Example:

150000

output
string | null
default:""

Total output amount in lovelaces

Example:

"25000000000000"

fees
string | null
default:""

Total fees in lovelaces

Example:

"180000000"

activeStake
string | null
default:""

Active stake in lovelaces

Example:

"24000000000000000"

{key}
any