banned - Monero

Example code for the banned JSON-RPC method. Complete guide on how to use banned JSON-RPC in GetBlock Web3 documentation.

This method checks whether a given IP address is currently banned on the node.

Parameters

Parameter	Type	Required	Description
address	string	Yes	IP address or hostname to check

Request Example

cURL

curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "banned",
    "params": {
        "address": "192.0.2.1"
    },
    "id": "getblock.io"
}'

JavaScript (Axios)

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "banned",
    "params": {
        "address": "192.0.2.1"
    },
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

Python (Requests)

import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "banned",
    "params": {
        "address": "192.0.2.1"
    },
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Rust (Reqwest)

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let payload = json!({
        "jsonrpc": "2.0",
        "method": "banned",
        "params": {
                "address": "192.0.2.1"
        },
        "id": "getblock.io"
});

    let response = client
        .post("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);

    Ok(())
}

Response Example

{
    "id": "getblock.io",
    "jsonrpc": "2.0",
    "result": {
        "banned": false,
        "seconds": 0,
        "status": "OK"
    }
}

Response Parameters

Field	Type	Description
result.banned	boolean	true if the address is currently banned
result.seconds	unsigned int	Seconds remaining on the ban (0 if not banned)
result.status	string	OK if the query succeeded

Use Cases

• Checking ban state for a specific IP

• Automated peer-health monitoring

Error Handling

Status Code	Error Message	Cause
404	not found	Missing or invalid <ACCESS-TOKEN>
-32602	Invalid params	Request parameters are missing or malformed
429	Too Many Requests	Rate limit exceeded for your plan

SDK Integration

monero-javascript

import monerojs from 'monero-javascript';

const daemon = await monerojs.connectToDaemonRpc('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/');

// Most methods are exposed directly on the daemon client. For raw access:
const result = await daemon.getDaemonConnection().sendJsonRequest('banned', {"address": "192.0.2.1"});
console.log(result);

monero-python

from monero.backends.jsonrpc import JSONRPCDaemon
from monero.daemon import Daemon

backend = JSONRPCDaemon(host='shared.eu-central-1.getblock.io', port=443, path='/<ACCESS-TOKEN>/', protocol='https')
daemon = Daemon(backend)

# For methods covered by the typed API, use the daemon attribute directly.
# For raw RPC access:
result = backend.raw_request('banned', {"address": "192.0.2.1"})
print(result)