Skip to content

setban JSON-RPC command

setban "subnet" "command" ( bantime absolute )

Attempts to add or remove an IP/Subnet from the banned list.


1. subnet      (string, required) The IP/Subnet (see getpeerinfo for nodes IP) with an optional netmask (default is /32 = single IP)
2. command     (string, required) 'add' to add an IP/Subnet to the list, 'remove' to remove an IP/Subnet from the list
3. bantime     (numeric, optional) time in seconds how long (or until when if [absolute] is set) the IP is banned (0 or empty means using the default time of 24h which can also be overwritten by the -bantime startup argument)
4. absolute    (boolean, optional) If set, the bantime must be an absolute timestamp in seconds since epoch (Jan 1 1970 GMT)


> bitcoin-cli setban "" "add" 86400
> bitcoin-cli setban "" "add"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "setban", "params": ["", "add", 86400] }' -H 'content-type: text/plain;'

Bitcoin Cash Node Daemon version v23.0.1-cc5d181

Documentation on reflects the current master branch in Git, and may include API changes that are not yet present in the latest release.