/v1/events | Alchemy Docs

Stream real-time beacon chain events from the beacon node. Subscribe by specifying one or more event topics using the topics query parameter.

Note: This is an EventSource (Server-Sent Events) style endpoint. The HTTP connection remains open and continuously pushes events as they occur.

Stream real-time beacon chain events from the beacon node. Subscribe by specifying one or more event topics using the `topics` query parameter. <Info> **Note:** This is an EventSource (Server-Sent Events) style endpoint. The HTTP connection remains open and continuously pushes events as they occur. </Info>

Query parameters

topicsstringRequired

Comma-separated list of event topics to subscribe to. Valid topics include: head, block, finalized_checkpoint, chain_reorg, voluntary_exit, and others depending on the beacon node implementation.

Response

This endpoint returns an object.

1	import requests
2
3	url = "https://eth-mainnetbeacon.g.alchemy.com/v2/docs-demo/eth/v1/events"
4
5	querystring = {"topics":"head"}
6
7	response = requests.get(url, params=querystring)
8
9	print(response.json())

1	{
2	"slot": "13052702",
3	"block": "0x3cf2223424524bf1094e2b010ea50b75e7914919c677d2702287bd423fd0f9b0",
4	"state": "0x9f27eb9578662934019ffc91d611a521e40e5b4d37c683f8cd6819ec0540c28d",
5	"current_duty_dependent_root": "0x0e45201599b353ea9f315dc466591929db1b555f2a3d5ed109bd46ff89b47ad0",
6	"previous_duty_dependent_root": "0xe6c5de54a9febcfd1c9f7edd95ba52e2353b19f970f82efe385947fdee0752f7",
7	"epoch_transition": false,
8	"execution_optimistic": false
9	}