eth_getBlockByNumber
Returns information about a block by number.
https://api.1inch.com/web3/8453
Supported on: Base
Parameters
Block (required)
Block
* any oneOf[0]
string oneOf[1]
string (Enum)`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
earliest
finalized
safe
latest
pending
Hydrated transactions (required)
Hydrated transactions
* boolean Request
Request
object jsonrpc
* string (Enum)JSON-RPC version
2.0
method
* string The method to call
params
array Method parameters
items
any oneOf[0]
any oneOf[0]
string oneOf[1]
string (Enum)`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
earliest
finalized
safe
latest
pending
oneOf[1]
boolean id
* number Request ID
JavaScript
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
const response = await fetch('https://api.1inch.com/web3/8453', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${API_KEY}`,
},
body: JSON.stringify({
jsonrpc: '2.0',
method: 'eth_getBlockByNumber',
params: ['string', false],
id: 1,
}),
});
const data = await response.json();
console.log(data);
Response
Block information
Block information
any oneOf[0]
null oneOf[1]
object hash
* string parentHash
* string sha3Uncles
* string miner
* string stateRoot
* string transactionsRoot
* string receiptsRoot
* string logsBloom
* string difficulty
string number
* string gasLimit
* string gasUsed
* string timestamp
* string extraData
* string mixHash
* string nonce
* string baseFeePerGas
string withdrawalsRoot
string blobGasUsed
string excessBlobGas
string parentBeaconBlockRoot
string size
* string transactions
* any anyOf[0]
array items
string anyOf[1]
array items
object oneOf[0]
object type
* string nonce
* string to
* string gas
* string value
* string input
* string maxPriorityFeePerGas
* string Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
gasPrice
string 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
* array EIP-2930 access lists
items
object address
* string storageKeys
* array items
string additionalProperties
none chainId
* string Chain ID that this transaction is valid on
authorizationList
* array List of authorizations for the transaction
items
object chainId
* string Chain ID on which this transaction is valid
nonce
* string address
* string yParity
* string The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature
r
* string s
* string yParity
* string The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string 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
* string s
* string oneOf[1]
object type
* string nonce
* string to
* string gas
* string value
* string input
* string maxPriorityFeePerGas
* string Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
maxFeePerBlobGas
* string The maximum total fee per gas the sender is willing to pay for blob gas in wei
gasPrice
string 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
* array EIP-2930 access list
items
object address
* string storageKeys
* array items
string additionalProperties
none blobVersionedHashes
* array List of versioned blob hashes associated with the transaction's EIP-4844 data blobs
items
string chainId
* string Chain ID that this transaction is valid on
yParity
* string The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string 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
* string s
* string oneOf[2]
object type
* string nonce
* string to
any oneOf[0]
null oneOf[1]
string gas
* string value
* string input
* string maxPriorityFeePerGas
* string Maximum fee per gas the sender is willing to pay to miners in wei
maxFeePerGas
* string The maximum total fee per gas the sender is willing to pay (includes the network / base fee and miner / priority fee) in wei
gasPrice
* string 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
* array EIP-2930 access list
items
object address
* string storageKeys
* array items
string additionalProperties
none chainId
* string Chain ID that this transaction is valid on.
yParity
* string The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string 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
* string s
* string oneOf[3]
object type
* string nonce
* string to
any oneOf[0]
null oneOf[1]
string gas
* string value
* string input
* string gasPrice
* string The gas price willing to be paid by the sender in wei
accessList
* array EIP-2930 access list
items
object address
* string storageKeys
* array items
string additionalProperties
none chainId
* string Chain ID that this transaction is valid on.
yParity
* string The parity (0 for even, 1 for odd) of the y-value of the secp256k1 signature.
v
string 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
* string s
* string oneOf[4]
object type
* string nonce
* string to
any oneOf[0]
null oneOf[1]
string gas
* string value
* string input
* string gasPrice
* string The gas price willing to be paid by the sender in wei
chainId
string Chain ID that this transaction is valid on.
v
* string r
* string s
* string blockHash
* string blockNumber
* string from
* string hash
* string transactionIndex
* string withdrawals
any oneOf[0]
null oneOf[1]
array items
object index
* string validatorIndex
* string address
* string amount
* string additionalProperties
none uncles
* array items
string requestsHash
any oneOf[0]
null oneOf[1]
string additionalProperties
none JSON
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
"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"
}