/eth/v1/events RPC Method

Parameters

topics

string

REQUIRED

The event types to subscribe to. The available values: head, block, attestation, voluntary_exit, finalized_checkpoint, chain_reorg, contribution_and_proof.

Returns

data

The object with the following values:

slot

string

The corresponding slot

block

string

The information about the specified block

state

string

The activation state

current_duty_dependent_root

string

The current duty dependent root

previous_duty_dependent_root

string

The previous duty dependent root

epoch_transition

boolean

The epoch transition

execution_optimistic

boolean

It's true if the response references an unverified execution payload. The optimistic information may be invalidated at a later time. If the field is not present, assume the false value

Request

curl -X GET \ 
    "https://docs-demo.quiknode.pro/eth/v1/events?topics=head" \
    -H "accept: text/event-stream"

const EventSource = require("eventsource");

let url = "https://docs-demo.quiknode.pro/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 = "https://docs-demo.quiknode.pro/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))

require "uri"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/eth/v1/events?topics=head")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "text/event-stream"

response = https.request(request)
puts response.read_body

Response

{
  "Connected": "to https://docs-demo.quiknode.pro/eth/v1/events?topics=head"
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free