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 Blocks API provides endpoints for retrieving block data from the Cardano blockchain. You can query the latest block, fetch historical blocks with pagination, or retrieve detailed information about specific blocks by hash.

Available endpoints

Get latest block

Retrieve the most recent block on the blockchain

Get block by hash

Fetch detailed information about a specific block

List blocks

Get a paginated list of blocks

Networks

All block endpoints support multiple Cardano networks:
NetworkDescription
MAINNETCardano mainnet (production)
PREPRODPre-production testnet
PREVIEWPreview testnet
TESTNETLegacy testnet
SANCHOGovernance testnet
Pass the network query parameter to specify which network to query. The default is PREPROD.

Block data structure

Each block response includes:
  • hash - Unique block identifier (64 hex characters)
  • height - Block height (sequential number)
  • slot - Slot number within the epoch
  • epoch - Epoch number containing this block
  • epoch_slot - Slot position within the epoch
  • slot_leader - Pool ID of the block producer
  • size - Block size in bytes
  • tx_count - Number of transactions in the block
  • output - Total output value in lovelace
  • fees - Total fees collected in lovelace
  • block_vrf - VRF verification key hash
  • previous_block - Hash of the previous block
  • next_block - Hash of the next block (null for latest)
  • confirmations - Number of confirmations

Example response

{
  "hash": "4e1ba9d3e6f6b5c8d9a7f3e1c2b4a5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "height": 8765432,
  "slot": 123456789,
  "epoch": 450,
  "epoch_slot": 123456,
  "slot_leader": "pool1abcdef123456789",
  "size": 24567,
  "tx_count": 42,
  "output": "34567890123456",
  "fees": "456789",
  "block_vrf": "vrf1abcdef...",
  "previous_block": "3d0ca8e2f5b4c7a6e8d9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
  "next_block": null,
  "confirmations": 0
}