The newHeads subscription type emits an event any time a new header (block) is added to the chain, including during a chain reorganization.

​
Body

id
number

Serves as a unique identifier for the request

jsonrpc
string

Indicates the version of JSON-RPC being used

method
string

Represents the name of the remote procedure or method to be called

params
array

Contains the list of parameters passed to the remote method

​
Response

jsonrpc
string

Returns the version of JSON-RPC being used

method
string

Returns the method of JSON-RPC call

params
object

Subscription result


{ "id": 1, "jsonrpc": "2.0", "method": "eth_subscribe", "params": ["newHeads"] }

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x969993ad38ffa8c6039a574965fb53d0"
}

{
    "jsonrpc": "2.0",
    "method": "eth_subscription",
    "params": {
        "subscription": "0x969993ad38ffa8c6039a574965fb53d0",
        "result": {
            "parentHash": "0xf337cec2ef21cb627e4523e40115d1ce91501ea328c6a54df94579c9cd8144d0",
            "sha3Uncles": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "miner": "0x0000000000000000000000000000000000000000",
            "stateRoot": "0x810c4c03c5d6fe352f0dfe2f1e012d788c4e266e2235e72afe5e1fbfc8f73735",
            "transactionsRoot": "0x9e58804240177676b3b48428cebe1df86d8b858c7c0757bba14cfe9069a9e0bd",
            "receiptsRoot": "0xbd9833e1612c9fe85957c8e462464fce2c87e914c72f8f8e0521112680c1825f",
            "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000100000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
            "difficulty": null,
            "number": "0x2",
            "gasLimit": "0x0",
            "gasUsed": "0x0",
            "timestamp": "0x64e2bc11",
            "extraData": "0x",
            "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "nonce": "0x0000000000000000",
            "baseFeePerGas": null,
            "withdrawalsRoot": null,
            "excessDataGas": null,
            "hash": "0x3fe7f9f07b0fc7ec6ba1749c8d52182463864051bf29c7466c7e2ae8ca23342f"
        }
    }
}