How to Access Ethereum RPC WebSocket

Learn how to connect with Ethereum WebSocket.

Supported WebSocket Methods

The Blockdaemon RPC API supports the following methods:

Event types

The WebSocket requests can subscribe to the following event types:

alchemy_minedTransactionsSubscribes to mined transactions and filters based on specified addresses.
alchemy_pendingTransactionsSubscribes to pending transactions and filters based on specified from and/or to addresses.
newPendingTransactionsSubscribes to all pending transactions.
newHeadsEmits events for new block headers.
logsEmit logs match the specified topics included in new blocks.

How To Access

Step 1: Authorize your request. Learn more: Authentication Guide

--headers 'Authorization: Bearer YOUR_API_KEY' 

Step 2: Use the following WebSocket URL:


Step 3: Specify an Ethereum method in the request body:

  • jsonrpc: Always "2.0".
  • id (int64): request ID.
  • method: Ethereum RPC WebSocket method. Such as eth_subscribe.
  • params:
    ├── Event types: The type of event to listen to (refer to Event types)
    └── Optional params: Optional parameters to describe the type of event to listen to (e.g., address)

For example, this request creates a new subscription for desired events.

--headers 'Authorization: Bearer YOUR_API_KEY' \
wss:// \
'{"jsonrpc":"2.0","id": 2, "method": "eth_subscribe", "params": ["newPendingTransactions"]}'

Step 4: It will return a response containing the subscription ID (subscription). It is included in all notifications and is required when unsubscribing.

  • jsonrpc: Always "2.0"
  • method: Indicates that this response is related to an Ethereum subscription.
  • params:
    ├── result: Object contains details about the transaction, including its hash.
  • subscription The subscription ID associated with this response.

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.