/eth/v1/events

Subscribe to beacon node events

Subscribe to beacon node events

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.

GEThttps://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>//eth/v1/events

Query parameters

Response

200400500

Opened SSE stream.

Body

text/event-stream

string

https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format

Request

JavaScriptCurlPython

const response = await fetch('https://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>//eth/v1/events?topics=head', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400500

text

Mainnet

curl -X GET \
    "https://mainnet.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/events?topics=head" \
    -H "accept: text/event-stream"

Testnet

curl -X GET \
    "https://sepolia.ethereum.validationcloud.io/v1/<YOUR_API_KEY_HERE>/eth/v1/events?topics=head" \
    -H "accept: text/event-stream"