Blocks
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 } }}