Skip to main content

The blocks field allows us to retrieve information about the blocks from the BNB blockchain.

Here is an example that demonstrates how to retrieve 10 latest blocks from BNB blockchains:

{
  ethereum (network: bsc){
    blocks(
      options: {limit: 10, desc: "timestamp.iso8601"}
      date: {after: "2023-07-18T00:00:00Z"}
    ) {
      gasLimit
      height
      hash
      timestamp {
        iso8601
      }
      difficulty
      size
      reward
      uncleCount
      transactionCount
      totalDifficulty
    }
  }
}
Filtering Blocks

Blocks data can be filtered using following arguments:

  • any: A catch-all field ( OR Logic) that can be used to filter on any other field in the blocks API.
  • blockHash: Filter by block hash.
  • blockReward: Filter by block reward given to the block producer.
  • date: Filter by the date on which the block was mined.
  • height: Filter by the height of the block.
  • miner: Filter by the miner who mined the block.
  • options: Filter returned data by ordering, limiting, and constraining it. Available fields: asc, ascByInteger, desc, descByInteger, limit, limitBy, offset.
  • size: Filter by the size of the block.
  • time: Filter by when the block was mined.
  • transactionCount: Filter by the number of transactions in the block.
  • any:
  • count: returns the aggregate count of blocks.
  • countBigInt: returns the aggregate count of blocks in BigInt format.
  • date: returns the date on which the block was mined.
  • difficulty: returns the block difficulty.
  • expression: performs arithematic operation and returns value of the operation
  • gasLimit: returns the gas limit for the block.
  • gasUsed: returns the gas used for that block.
  • hash: returns the hash of the block.
  • height: returns the height of the block.
  • maximum: returns the maximum of selected measurable fields of Ethereum Blocks
  • miner: returns the miner of the block.
  • minimum: returns the minimum of selected measurable fields of Ethereum Blocks
  • nonce: returns the nonce of the block.
  • parentHash: returns the parent hash for the block.
  • reward: returns the reward given to the miner for producing the block.
  • rewardCurrency: returns the reward currency.
  • size: returns the block size.
  • timestamp: returns the timestamp when the block was mined.
  • totalDifficulty: returns the total difficulty.
  • transactionCount: returns the number of transactions included in the block.
  • transactionCountBigInt:
  • uncleCount:
  • uncleCountBigInt: