Skip to main content

/blocks

Returns a list of all blocks from all shards​

Parameters​

  • from OPTIONAL (number) - Number of items to skip for the result set
  • size OPTIONAL (number) - Number of items to retrieve
  • shard OPTIONAL (number) - Id of the shard the block belongs to
  • proposer OPTIONAL (string) - Filter by propose
  • validator OPTIONAL (string) - Filter by validator
  • epoch OPTIONAL (number) - Filter by epoch
  • nonce OPTIONAL (number) - Filter by nonce
  • withProposerIdentity OPTIONAL (boolean) - Provide identity information for proposer node

Returns​

  • object:
    • hash : (string) - The hash of the transaction
    • epoch : (number) - The epoch number
    • nonce : (string) - The Block nonce (height)
    • prevHash : (string) - Previous hash of the transaction
    • proposer : (string) - The hash of the proposer
    • pubKeyBitmap : (string)
    • round : (number) - fixed time duration, consistent across the network, currently decided to be 5 seconds
    • shard : (number) - Id of the shard
    • size : (number) - The account sequence number
    • sizeTxs : (number) - The total transaction size in bytes
    • stateRootHash : (string)
    • timestamp : (number) - u64 format
    • txCount : (number)
    • gasConsumed : (number) - Is the consumed amount from the provided gas limit - the amount of gas units actually required by the Network in order to process the transaction
    • gasRefunded : (number) - Is the amount of gas refunded from the provided gas limit
    • gasPenalized : (number)
    • maxGasLimit : (number) - The maximum number of gas units allocated for the transaction

Example​

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/blocks' \
  -H 'accept: application/json'

Result

[
  {
    "hash": "bf1b3e3b4b7d4258efadcd332a1f46a1e1b1788b1cc0633c140c62b0dff20967",
    "epoch": 755,
    "nonce": 10883650,
    "prevHash": "7a750165236239830fc693c5542f2ba0a1766ac5288f45858660c27b706051c6",
    "proposer": "e63921070b8ceb151076af8c7f0b62ddde15dd41f0bea2e3d2c567063b3e5cdd805058c63df24469c7d79bb11241481582b329f5974c41996af50d840913a984584d9af684e6705783111bf64f827b42b5d19b8a682e9322eb1497b99606a702",
    "pubKeyBitmap": "ffffffffffffff7f",
    "round": 10887152,
    "shard": 0,
    "size": 733,
    "sizeTxs": 1657,
    "stateRootHash": "afca893fe24d288562e881b6cacadca4b71bec46ed4d19ab274c9a6f1da3bd65",
    "timestamp": 1661440512,
    "txCount": 6,
    "gasConsumed": 0,
    "gasRefunded": 0,
    "gasPenalized": 0,
    "maxGasLimit": 3000000000
  }
]