eth_unsubscribe | Alchemy Docs

Cancels an active subscription given its subscription ID.

⚠️ 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.

Cancels an active subscription given its subscription ID. ⚠️ **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](https://docs.alchemy.com/reference/subscription-api) for examples.

Path Parameters

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.

Subscription IDstringOptionalformat: "^0x[0-9a-f]{64}$"

The identifier of the subscription to cancel.

Response

A boolean indicating whether the subscription was successfully canceled.

1	curl -X POST https://eth-mainnet.g.alchemy.com/v2/{apiKey} \
2	-H "Content-Type: application/json" \
3	-d '{
4	"jsonrpc": "2.0",
5	"method": "eth_unsubscribe",
6	"params": [
7	"0x9c7c3f3c3c63b1b89ac0c1e0b0d3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8090a1b"
8	],
9	"id": 1
10	}'