Skip to main content
Returns all archived block data. While user commands and snark work is also available, they each have dedicated collections to ease the querying and filtering of very deeply nested objects.

​
Return the last 10 blocks from the canonical chain

{
  blocks(query: { canonical: true }, sortBy: DATETIME_DESC, limit: 10) {
    creatorAccount {
      publicKey
    }
    stateHash
    dateTime
    protocolState {
      consensusState {
        blockHeight
      }
    }
    transactions {
      coinbase
    }
  }
}

​
Find all blocks produced by a public key

This query returns all blocks seen by the explorer node, whether on the canonical chain or not. 
{
  blocks(
    query: {
      creatorAccount: {
        publicKey: "B62qnZwmdaN8yHvonypfcHxCn2dRb3fRK7jKK8CmrG3trRhuUfE58iA"
      }
    }
    sortBy: DATETIME_DESC
  ) {
    creatorAccount {
      publicKey
    }
    stateHash
    protocolState {
      consensusState {
        blockHeight
      }
    }
  }
}

​
Find all blocks produced past a certain date

Add a date filter to limit your blocks by date. 
{
  blocks(
    query: {
      dateTime_gte: "2021-01-31T00:00:00Z"
    }
    sortBy: DATETIME_DESC
  ) {
    creatorAccount {
      publicKey
    }
    dateTime
    stateHash
    protocolState {
      consensusState {
        blockHeight
      }
    }
  }
}

​
Find a block by state hash

Get the full details for a block based on the protocol state hash of the block.
When returning a single result, you can use the block query. The blocks query will return multiple matching results. 
{
  block(
    query: {
      stateHash: "3NKF9BSvELt38KqhCYRVTjfY6BbGLHSXqQjoXRa51MRUCE736Wsh"
    }
  ) {
    creatorAccount {
      publicKey
    }
    dateTime
    stateHash
    protocolState {
      consensusState {
        blockHeight
      }
    }
  }
}

​
Find a canonical block by height

Find the canonical block for a specific height. Remember that a canonical block can be updated for k blocks before it reaches finality! 
{
  block(
    query: {canonical: true, blockHeight: 1212}
  ) {
    stateHash
    protocolState {
      consensusState {
        blockHeight
      }
    }
    winnerAccount {
      publicKey
    }
    creatorAccount {
      publicKey
    }
    transactions {
      coinbase
    }
  }
}

​
Return all blocks between two heights

Filter your queries based on the block height to retrieve a range of blocks based on height. 
{
  blocks(
    query: {
      AND: [
        { canonical: true }
        { blockHeight_gte: 100 }
        { blockHeight_lte: 105 }
      ]
    }
  ) {
    stateHash
    protocolState {
      consensusState {
        blockHeight
      }
    }
    winnerAccount {
      publicKey
    }
    creatorAccount {
      publicKey
    }
    transactions {
      coinbase
    }
  }
}