# eth_getBlockByNumber > For the complete documentation index, see [llms.txt](/docs/llms.txt). POST https://scroll-mainnet.g.alchemy.com/v2/{apiKey} Returns information about a block by its number. Reference: https://www.alchemy.com/docs/chains/scroll/scroll-api-endpoints/eth-get-block-by-number ## Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | Block number or tag | string or enum | Yes | The block number or special tags like 'latest', 'earliest', or 'pending'. | | Hydrated transactions | boolean | Yes | If true, returns full transaction objects; if false, returns only transaction hashes. | ## Result **Block information** (null or object): The block object containing various properties of the block. ## Example ### Request ```json { "jsonrpc": "2.0", "method": "eth_getBlockByNumber", "params": [ "0x68b3", false ], "id": 1 } ``` ### Response ```json { "jsonrpc": "2.0", "result": { "number": "0x68b3", "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c", "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d", "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d", "nonce": "0x378da40ff335b070", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000", "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126", "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233", "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a", "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d", "difficulty": "0x66e619a", "totalDifficulty": "0x1e875d746ae", "extraData": "0xd583010502846765746885676f312e37856c696e7578", "size": "0x334", "gasLimit": "0x47e7c4", "gasUsed": "0x37993", "timestamp": "0x5835c54d", "uncles": [], "transactions": [ "0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc", "0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d" ], "baseFeePerGas": "0x7", "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f", "withdrawals": [ { "index": "0x0", "validatorIndex": "0x9d8c0", "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f", "amount": "0x11a33e3760" } ], "blobGasUsed": "0x0", "excessBlobGas": "0x0", "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685" }, "id": 1 } ``` ## Code Examples ### cURL ```bash curl --request POST \ --url https://scroll-mainnet.g.alchemy.com/v2/docs-demo \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "id": 1, "method": "eth_getBlockByNumber", "params": [ "0x68b3", false ] }' ``` ### JavaScript ```javascript const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_getBlockByNumber', params: ['0x68b3', false] }) }; fetch('https://scroll-mainnet.g.alchemy.com/v2/docs-demo', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://scroll-mainnet.g.alchemy.com/v2/docs-demo" payload = { "jsonrpc": "2.0", "id": 1, "method": "eth_getBlockByNumber", "params": ["0x68b3", False] } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Go ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://scroll-mainnet.g.alchemy.com/v2/docs-demo" payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"eth_getBlockByNumber\",\n \"params\": [\n \"0x68b3\",\n false\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ### Java ```java HttpResponse response = Unirest.post("https://scroll-mainnet.g.alchemy.com/v2/docs-demo") .header("Content-Type", "application/json") .body("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"eth_getBlockByNumber\",\n \"params\": [\n \"0x68b3\",\n false\n ]\n}") .asString(); ``` ### C# ```csharp using RestSharp; var options = new RestClientOptions("https://scroll-mainnet.g.alchemy.com/v2/docs-demo"); var client = new RestClient(options); var request = new RestRequest(""); request.AddJsonBody("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"eth_getBlockByNumber\",\n \"params\": [\n \"0x68b3\",\n false\n ]\n}", false); var response = await client.PostAsync(request); Console.WriteLine("{0}", response.Content); ``` ## OpenRPC Method Specification ```yaml name: eth_getBlockByNumber description: Returns information about a block by its number. params: - name: Block number or tag required: true description: The block number or special tags like 'latest', 'earliest', or 'pending'. schema: title: Block number or tag oneOf: - title: Block number type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ - title: Block tag type: string enum: - earliest - finalized - safe - latest - pending description: '`earliest`: The lowest numbered block the client has available; `finalized`: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; `safe`: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; `latest`: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; `pending`: A sample next block built by the client on top of `latest` and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for `finalized` or `safe` block MUST be responded to with `-39001: Unknown block` error' - name: Hydrated transactions required: true description: If true, returns full transaction objects; if false, returns only transaction hashes. schema: title: hydrated type: boolean result: name: Block information description: The block object containing various properties of the block. schema: oneOf: - title: Not Found (null) type: 'null' - title: Block object type: object required: - hash - parentHash - sha3Uncles - miner - stateRoot - transactionsRoot - receiptsRoot - logsBloom - number - gasLimit - gasUsed - timestamp - extraData - mixHash - nonce - size - transactions - uncles additionalProperties: false properties: hash: title: Hash type: string pattern: ^0x[0-9a-f]{64}$ parentHash: title: Parent block hash type: string pattern: ^0x[0-9a-f]{64}$ sha3Uncles: title: Ommers hash type: string pattern: ^0x[0-9a-f]{64}$ miner: title: Coinbase type: string pattern: ^0x[0-9a-fA-F]{40}$ stateRoot: title: State root type: string pattern: ^0x[0-9a-f]{64}$ transactionsRoot: title: Transactions root type: string pattern: ^0x[0-9a-f]{64}$ receiptsRoot: title: Receipts root type: string pattern: ^0x[0-9a-f]{64}$ logsBloom: title: Bloom filter type: string pattern: ^0x[0-9a-f]{512}$ difficulty: title: Difficulty type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ number: title: Number type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ gasLimit: title: Gas limit type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ gasUsed: title: Gas used type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ timestamp: title: Timestamp type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ extraData: title: Extra data type: string pattern: ^0x[0-9a-f]*$ mixHash: title: Mix hash type: string pattern: ^0x[0-9a-f]{64}$ nonce: title: Nonce type: string pattern: ^0x[0-9a-f]{16}$ baseFeePerGas: title: Base fee per gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ withdrawalsRoot: title: Withdrawals root type: string pattern: ^0x[0-9a-f]{64}$ blobGasUsed: title: Blob gas used type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ excessBlobGas: title: Excess blob gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ parentBeaconBlockRoot: title: Parent Beacon Block Root type: string pattern: ^0x[0-9a-f]{64}$ size: title: Block size type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ transactions: anyOf: - title: Transaction hashes type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ - title: Full transactions type: array items: type: object title: Transaction information required: - blockHash - blockNumber - from - hash - transactionIndex unevaluatedProperties: false oneOf: - title: Signed 4844 Transaction type: object required: - accessList - blobVersionedHashes - chainId - gas - input - maxFeePerBlobGas - maxFeePerGas - maxPriorityFeePerGas - nonce - r - s - to - type - value - yParity properties: type: title: type type: string pattern: ^0x([0-9a-fA-F]?){1,2}$ nonce: title: nonce type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ to: title: to address type: string pattern: ^0x[0-9a-fA-F]{40}$ gas: title: gas limit type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ value: title: value type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ input: title: input data type: string pattern: ^0x[0-9a-f]*$ maxPriorityFeePerGas: title: max priority fee per gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Maximum fee per gas the sender is willing to pay to miners in wei maxFeePerGas: title: max fee per gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei maxFeePerBlobGas: title: max fee per blob gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The maximum total fee per gas the sender is willing to pay for blob gas in wei accessList: title: accessList description: EIP-2930 access list type: array items: title: Access list entry type: object additionalProperties: false properties: address: title: hex encoded address type: string pattern: ^0x[0-9a-fA-F]{40}$ storageKeys: type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ blobVersionedHashes: title: blobVersionedHashes description: List of versioned blob hashes associated with the transaction's EIP-4844 data blobs. type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ chainId: title: chainId type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Chain ID that this transaction is valid on. yParity: title: yParity type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature. r: title: r type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ s: title: s type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ - title: Signed 1559 Transaction type: object required: - accessList - chainId - gas - gasPrice - input - maxFeePerGas - maxPriorityFeePerGas - nonce - r - s - type - value - yParity properties: type: title: type type: string pattern: ^0x2$ nonce: title: nonce type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ to: title: to address oneOf: - title: Contract Creation (null) type: 'null' - title: Address type: string pattern: ^0x[0-9a-fA-F]{40}$ gas: title: gas limit type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ value: title: value type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ input: title: input data type: string pattern: ^0x[0-9a-f]*$ maxPriorityFeePerGas: title: max priority fee per gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Maximum fee per gas the sender is willing to pay to miners in wei maxFeePerGas: title: max fee per gas type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei gasPrice: title: gas price type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The effective gas price paid by the sender in wei. For transactions not yet included in a block, this value should be set equal to the max fee per gas. This field is DEPRECATED, please transition to using effectiveGasPrice in the receipt object going forward. accessList: title: accessList description: EIP-2930 access list type: array items: title: Access list entry type: object additionalProperties: false properties: address: title: hex encoded address type: string pattern: ^0x[0-9a-fA-F]{40}$ storageKeys: type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ chainId: title: chainId type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Chain ID that this transaction is valid on. yParity: title: yParity type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature. v: title: v type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`. r: title: r type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ s: title: s type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ - title: Signed 2930 Transaction type: object required: - accessList - chainId - gas - gasPrice - input - nonce - r - s - type - value - yParity properties: type: title: type type: string pattern: ^0x1$ nonce: title: nonce type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ to: title: to address oneOf: - title: Contract Creation (null) type: 'null' - title: Address type: string pattern: ^0x[0-9a-fA-F]{40}$ gas: title: gas limit type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ value: title: value type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ input: title: input data type: string pattern: ^0x[0-9a-f]*$ gasPrice: title: gas price type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The gas price willing to be paid by the sender in wei accessList: title: accessList description: EIP-2930 access list type: array items: title: Access list entry type: object additionalProperties: false properties: address: title: hex encoded address type: string pattern: ^0x[0-9a-fA-F]{40}$ storageKeys: type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ chainId: title: chainId type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Chain ID that this transaction is valid on. yParity: title: yParity type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature. v: title: v type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: For backwards compatibility, `v` is optionally provided as an alternative to `yParity`. This field is DEPRECATED and all use of it should migrate to `yParity`. r: title: r type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ s: title: s type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ - title: Signed Legacy Transaction type: object required: - gas - gasPrice - input - nonce - r - s - type - v - value properties: type: title: type type: string pattern: ^0x0$ nonce: title: nonce type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ to: title: to address oneOf: - title: Contract Creation (null) type: 'null' - title: Address type: string pattern: ^0x[0-9a-fA-F]{40}$ gas: title: gas limit type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ value: title: value type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ input: title: input data type: string pattern: ^0x[0-9a-f]*$ gasPrice: title: gas price type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: The gas price willing to be paid by the sender in wei chainId: title: chainId type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ description: Chain ID that this transaction is valid on. v: title: v type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ r: title: r type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ s: title: s type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ properties: blockHash: title: block hash type: string pattern: ^0x[0-9a-f]{64}$ blockNumber: title: block number type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ from: title: from address type: string pattern: ^0x[0-9a-fA-F]{40}$ hash: title: transaction hash type: string pattern: ^0x[0-9a-f]{64}$ transactionIndex: title: transaction index type: string pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$ withdrawals: title: Withdrawals type: array items: type: object title: Validator withdrawal required: - index - validatorIndex - address - amount additionalProperties: false properties: index: title: index of withdrawal type: string pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$ validatorIndex: title: index of validator that generated withdrawal type: string pattern: ^0x([1-9a-f]+[0-9a-f]{0,15})|0$ address: title: recipient address for withdrawal value type: string pattern: ^0x[0-9a-fA-F]{40}$ amount: title: value contained in withdrawal type: string pattern: ^0x([1-9a-f]+[0-9a-f]{0,31})|0$ uncles: title: Uncles type: array items: title: 32 byte hex value type: string pattern: ^0x[0-9a-f]{64}$ examples: - name: eth_getBlockByNumber example params: - name: Block number or tag value: '0x68b3' - name: Hydrated transactions value: false result: name: Block information value: number: '0x68b3' hash: '0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c' mixHash: '0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d' parentHash: '0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d' nonce: '0x378da40ff335b070' sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347' logsBloom: '0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000' transactionsRoot: '0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126' stateRoot: '0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233' receiptsRoot: '0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a' miner: '0xb42b6c4a95406c78ff892d270ad20b22642e102d' difficulty: '0x66e619a' totalDifficulty: '0x1e875d746ae' extraData: '0xd583010502846765746885676f312e37856c696e7578' size: '0x334' gasLimit: '0x47e7c4' gasUsed: '0x37993' timestamp: '0x5835c54d' uncles: [] transactions: - '0xa0807e117a8dd124ab949f460f08c36c72b710188f01609595223b325e58e0fc' - '0xeae6d797af50cb62a596ec3939114d63967c374fa57de9bc0f4e2b576ed6639d' baseFeePerGas: '0x7' withdrawalsRoot: '0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f' withdrawals: - index: '0x0' validatorIndex: '0x9d8c0' address: '0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f' amount: '0x11a33e3760' blobGasUsed: '0x0' excessBlobGas: '0x0' parentBeaconBlockRoot: '0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685' ```