eth_unsubscribe - Polygon

Example code for the eth_unsubscribe json-rpc method. Сomplete guide on how to use eth_unsubscribe json-rpc in GetBlock.io Web3 documentation.

The eth_unsubscribe method cancels a subscription created with eth_subscribe. The subscription will no longer send notifications after this call.

This method requires a WebSocket connection.

Parameters

Parameter

Type

Required

Description

subscriptionId

string

Yes

Subscription ID returned by eth_subscribe

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_unsubscribe",
    "params": ["0x9cef478923ff08bf67fde6c64013158d"],
    "id": "getblock.io"
}'

example.js

import axios from 'axios';

const url = 'https://go.getblock.io/<ACCESS-TOKEN>/';

const payload = {
    jsonrpc: '2.0',
    method: 'eth_unsubscribe',
    params: ["0x9cef478923ff08bf67fde6c64013158d"],
    id: 'getblock.io'
};

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

example.py

import requests

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = {
    "jsonrpc": "2.0",
    "method": "eth_unsubscribe",
    "params": ["0x9cef478923ff08bf67fde6c64013158d"],
    "id": "getblock.io"
}

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
print(response.json())

example.rs

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "eth_unsubscribe",
            "params": ["0x9cef478923ff08bf67fde6c64013158d"],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

This method requires a WebSocket connection for subscriptions created with eth_subscribe. Use eth_unsubscribe to cancel those subscriptions.

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": true
}

Response Parameters

Field

Type

Description

jsonrpc

string

JSON-RPC version (2.0)

string

Request identifier

result

varies

Boolean indicating success

Use Case

The eth_unsubscribe method is useful for:

Subscription cleanup
Resource management

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN

-32600

Invalid Request

Malformed request body

-32602

Invalid params

Invalid method parameters

Web3 Integration

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const result = await provider.send('eth_unsubscribe', ["0x9cef478923ff08bf67fde6c64013158d"]);
console.log('Result:', result);

viem.js

import { createPublicClient, http } from 'viem';
import { polygon } from 'viem/chains';

const client = createPublicClient({
    chain: polygon,
    transport: http('https://go.getblock.io/<ACCESS-TOKEN>/')
});

const result = await client.request({
    method: 'eth_unsubscribe',
    params: ["0x9cef478923ff08bf67fde6c64013158d"]
});
console.log('Result:', result);

Previouseth_uninstallFilter - Polygon Nextnet_listening - Polygon

Last updated 17 days ago

Was this helpful?

hashtagParameters

hashtagRequest

hashtagResponse

hashtagResponse Parameters

hashtagUse Case

hashtagError Handling

hashtagWeb3 Integration

Parameters

Request

Response

Response Parameters

Use Case

Error Handling

Web3 Integration