Skip to main content
GET
Get latest epoch information

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>
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 latest 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