eth-v1-events - Ethereum RPC method documentation

Chain

eth-v1-events RPC method

Provides endpoint to subscribe to beacon node Server-Sent-Events stream. Consumers should use eventsource implementation to listen on those events. Servers may send SSE comments beginning with : for any purpose, including to keep the event stream connection alive in the presence of proxy servers.

Parameters:

topics - array[string] - (Required) Event types to subscribe to. Available values: head, block, attestation, voluntary_exit, finalized_checkpoint, chain_reorg, contribution_and_proof.

Returns:

data - object - with the following values:
slot - string

block - string

state - string

current_duty_dependent_root - string

previous_duty_dependent_root - string

epoch_transition - boolean

execution_optimistic - boolean

Code Examples:

javascript
python
curl

const EventSource = require("eventsource");

let url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/eth/v1/events?topics=head"
let eventSourceInitDict = {headers: {'Accept': 'text/event-stream'}};

async function main() {
  let es = new EventSource(url, eventSourceInitDict);

  es.addEventListener('head', function (e) {
      console.log(e.data)
  })
}

main();

import json
import sseclient
import requests

url = "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/eth/v1/events?topics=head"

response = requests.get(url, stream=True, headers={'Accept': 'text/event-stream'})
client = sseclient.SSEClient(response)

for event in client.events():
    subscriptionData = json.loads(event.data)
    print(json.dumps(subscriptionData, indent=2))

curl -X GET \ 
    "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/eth/v1/events?topics=head" \
    -H "accept: text/event-stream"

Ready to get started? Create a free account

Eth V1 Events

Contents

eth-v1-events RPC method