> For the complete documentation index, see [llms.txt](https://docs.triton.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.triton.one/monad/rpc-methods/subscriptions/eth_subscribe.md).

# eth\_subscribe

Open a push subscription over a WebSocket connection. Monad adds monadNewHeads and monadLogs streams that also report each block's commit state.

Open a push subscription over a WebSocket connection (`wss://`). Monad supports the standard `newHeads` and `logs` subscriptions, plus two Monad extensions that also report each block's commit state. All four publish a block when it is proposed, before it is finalized.

## Request

{% tabs %}
{% tab title="WebSocket message" %}

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_subscribe",
  "params": [
    "newHeads"
  ]
}
```

{% endtab %}
{% endtabs %}

Connect to `wss://<your-endpoint>.mainnet.monad.rpcpool.com/<your-token>`.

## Subscription types

| Type            | Description                                                                                                                                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `newHeads`      | New block headers, published once per block when the block is proposed.                                                                                                                                                   |
| `logs`          | Logs matching a filter object passed as the second parameter, published when the block is proposed.                                                                                                                       |
| `monadNewHeads` | The same headers with `blockId` and `commitState` fields. A block is published again each time its `commitState` advances to `Voted`, `Finalized`, or `Verified`. A block can go from `Proposed` straight to `Finalized`. |
| `monadLogs`     | The same logs with `blockId` and `commitState` fields, published again each time the block's `commitState` advances.                                                                                                      |

A proposed block can still be abandoned. If you need finality, subscribe to `monadNewHeads` or `monadLogs` and wait for `commitState` `Finalized`.

## Not supported

Monad does not support the `newPendingTransactions` or `syncing` subscriptions, nor EIP-4844 blob transactions.

***

<i class="fa-life-ring">:life-ring:</i> Contact support by clicking the chat icon in your [customer dashboard](https://customers.triton.one)\ <i class="fa-briefcase">:briefcase:</i> Sales questions? [Contact us](https://triton.one/contact)\ <i class="fa-sparkles">:sparkles:</i> AI agent? Read [llms.txt](https://docs.triton.one/llms.txt)\ <i class="fa-rss">:rss:</i> Follow updates: [Blog](https://blog.triton.one) · [X](https://x.com/triton_one) · [YouTube](https://www.youtube.com/@triton_one_ltd) · [Telegram](https://t.me/tritonone) · [GitHub](https://github.com/rpcpool)