Links

getBlock

Get the contents of a block
Efficiently access the contents of a block using either its block number or block hash as query parameters.

How to use getBlock method ?

Below, you'll find an in-depth guide that provides a comprehensive explanation of how to utilize the getBlock method effectively using Blast Builder API.

Parameters

Field
Type
Description
blockNumberOrHash *
string
This parameter is essential and must be provided. Depending on the value you specify, whether it's the block height or block hash, it will initiate the retrieval of the block contents.

Result

Field
Type
Description
blockHash
string
This represents the hash of the specified block
blockNumber
number
This represents the height of the specified block
blockTimestamp
string
The timestamp of the block
parentBlockHash
string
The hash that identifies the previous block in the chain
sequencerAddress
string
The sequencer address that constructed the block
stateRoot
string
The state commitment after this block
status
string
The status of the block
totalActualFee
string
The gas fee the transaction paid
transactionCount
string
The number of transactions in the specified block
eventCount
number
The number of events
messageCount
string
The number of messages

Example Request and Result for getBlock

In this section, we provide an illustrative example of a request made to retrieve block contents using the getBlock Builder API method. Additionally, we present the resulting response containing information about the specified block. This example demonstrates how to interact with the API to obtain details about a specific block, including its hash, block number, timestamp, and various other attributes. Developers can use this as a reference for crafting their own requests and parsing the returned data when working with the getBlock Builder API method.
The example in this section uses a non-existing project id.
Make sure you replace it with your Starknet endpoint when issuing the Builder API calls.
Don't have a project id? Here's a straightforward guide on how to obtain one!
get
https://starknet-mainnet.blastapi.io/<project-id>/builder/getBlock?
Return the contents of a block by blockNumber or blockHash
Parameters
Query
blockNumberOrHash*
501652
Responses
200: OK
Expand for a detailed response example

Curl Request example

curl -X GET https://starknet-mainnet.blastapi.io/<project-id>/builder/getBlock?blockNumberOrHash=501652 -H 'Content-Type: application/json'
Last modified 1mo ago