ban_pubkey
ban_pubkey pubkey reason
The ban_pubkey method bans the selected pubkey ignoring its order matching messages and preventing its orders from displaying in the orderbook.
Arguments
| Structure | Type | Description |
|---|---|---|
| pubkey | string | The pubkey to ban |
| reason | string | Optional. The reason for banning |
| duration_min | integer | Optional. Minutes to apply the ban. If not set, ban will persist until kdf is restarted. |
Response
| Structure | Type | Description |
|---|---|---|
| result | string | whether the ban was successful |
📌 Examples
Command
POST ban_pubkey
{
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
} curl --url "http://127.0.0.1:7783" --data '{
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
}' import requests
import json
url = "http://127.0.0.1:7783"
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
}
response = requests.post(url, json=payload)
print(json.dumps(response.json(), indent=2)) const payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
};
const response = await fetch("http://127.0.0.1:7783", {
method: "POST",
body: JSON.stringify(payload),
});
console.log(await response.json()); <?php
$payload = <<<'JSON'
{
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
}
JSON;
$ch = curl_init("http://127.0.0.1:7783");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
echo $response; package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{"userpass":"RPC_UserP@SSW0RD","method":"ban_pubkey","pubkey":"2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420","reason":"Being a naughty boy","duration_min":15}`)
resp, err := http.Post("http://127.0.0.1:7783", "application/json", bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
} require 'net/http'
require 'json'
require 'uri'
uri = URI("http://127.0.0.1:7783")
payload = {
"userpass": "RPC_UserP@SSW0RD",
"method": "ban_pubkey",
"pubkey": "2cd3021a2197361fb70b862c412bc8e44cff6951fa1de45ceabfdd9b4c520420",
"reason": "Being a naughty boy",
"duration_min": 15
}
response = Net::HTTP.post(uri, payload.to_json, 'Content-Type' => 'application/json')
puts JSON.pretty_generate(JSON.parse(response.body)) Show Response
Response (success)
{
"result": "success"
}Error (already banned)
{
"error": "rpc:208] dispatcher_legacy:160] pubkey_banning:58] Pubkey is banned already"
}Error (invalid pubkey)
{
"error": "rpc:184] dispatcher_legacy:140] pubkey_banning:63] invalid value: string \"2102f7597468703c1c5c8465dd6d43acaae697df9df30bed21494d193412a1ea193eac\", expected a hash string"
}