eth

ETH

POST

GET

chevron-right

Last updated on January 1, 1970

1 min read

Method eth_subscribe undefined ()
connect with JSON-RPC protocol

eth_subscribe

info-circle-fill

Subscribes to a specified event type, optionally restricted to one ormany objects. This method is available via websocket only.

Parameters

type - string

A subscription type, such as newHeads (new headers appended to the chain, including chain reorganizations), logs (logs that are included in new imported blocks and match the given filter criteria) or newPendingTransactions (hashes for all transactions that are added to the pending state and are signed with a key that is available in the node).

objects - hex string

Optional argumants such as an address, multiple addresses, and topics.

Request

curl --location --request POST 'https://eth.getblock.io/mainnet/' 
--header 'x-api-key: YOUR-API-KEY' 
--header 'Content-Type: application/json' 
--data-raw '{"jsonrpc": "2.0",
"method": "eth_subscribe",
"params": ["newHeads", null],
"id": "getblock.io"}'

Response

{
    "error": {
        "code": -32001,
        "message": "notifications not supported"
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}
banner icon

Start Building with GetBlock RPCs for Free