Retrieves all the uncles within the specified range.
When two miners solve a block at roughly the same time, the network can only include one of them in the blockchain, while the other one is considered an "uncle."
In a PoS (Proof of Stake) network, block validation is done by validators who are chosen to validate blocks based on the amount of stake they hold, rather than by miners who must compete to solve complex computational problems. As a result, there is typically no concept of an "uncle" block in a PoS network, but historical uncle data pre-Ethereum Merge would still be available with this endpoint.
*Note: Ethereum finalized 'The Merge' at block 15537393 on September 15, 2022, at 1:42:42 EST
Blockchains Supported
This endpoint supports Ethereum.
Response Data
| Field | Type | Description |
|---|---|---|
| baseFeePerGas | number | Minimum fee required for the transaction to be included in the block. |
| blockNumber | string | The scalar value equal to the number of ancestor blocks of the block this uncle is attached to. |
| difficulty | string | A scalar value corresponding to the difficulty level of this block. |
| extraData | string | An arbitrary byte array containing data relevant to this block. |
| gasLimit | string | The scalar value equal to the current limit of gas expenditure per block. |
| gasUsed | string | The scalar value equal to the total gas used in transactions in this block. |
| hash | string | Uncle header hash. |
| logsBloom | string | The Bloom filter composed from indexable information (logger address and log topics) contained in each log entry from the receipt of each transaction in the transactions list. |
| miner | string | The 160-bit address to which all fees collected from the successful mining of this block be transferred. |
| mixHash | string | The 256-bit hash which proves combined with the nonce that a sufficient amount of computation has been carried out on this block. |
| nonce | string | The 64-bit hash which proves combined with the mix-hash that a sufficient amount of computation has been carried out on this block |
| number | string | The uncle's blockNumber. |
| parentHash | string | The Keccak 256-bit hash of the parent block’s header. |
| positionIndex | number | The index of the uncle in relation to the other uncles of the same block. |
| reward | string | The mining reward for the uncle. See full value conversion reference here. |
| receiptsRoot | string | The Keccak 256-bit hash of the root node of the trie structure populated with the receipts of each transaction in the transactions list portion of the block. |
| sha3Uncles | string | The combined hash of alluncles for a given parent. |
| size | number | The size of the block in bytes. |
| stateRoot | string | The Keccak 256-bit hash of the root node of the state trie, after all transactions are executed and finalisations applied. |
| timestamp | string | The scalar value equal to the reasonable output of Unix’s time() at this block’s inception. |
| totalDifficulty | string | The total difficulty of the chain. |
| transactionsRoot | string | The Keccak 256-bit hash of the root node of the trie structure populated with each transaction in the transactions list portion of the block. |