eth_subscribe

POST

/{apiKey}

Subscribes to specific event types and returns a subscription ID to receive asynchronous notifications via the eth_subscription method.

⚠️ WARNING: WebSocket-Only Method ⚠️

This method REQUIRES a WebSocket connection using wss:// protocol. It will NOT work with standard HTTP/HTTPS requests or curl. See the WebSocket documentation for examples.

Path Parameters

apiKeystringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

Subscription Typestring

The type of event to subscribe to (e.g., "newHeads", "logs", "newPendingTransactions", "syncing").

Optionsobject

Optional subscription parameters, such as filtering topics for logs.

Responses

200

A unique identifier for the subscription, returned as a 32-byte hex string.

POST/v2/{apiKey}

curl --request POST \  --url https://hyperliquid-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "eth_subscribe",  "params": [    "newHeads",    {}  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": "0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b"}

Was this page helpful?