Skip to content

listbanned JSON-RPC command

listbanned

List all manually banned IPs/Subnets.

Result

{
  "address": "xxx",       (string) The IP/Subnet of the banned node
  "ban_created": n,       (numeric) The UNIX epoch time the ban was created
  "banned_until": n,      (numeric) The UNIX epoch time the ban expires
  "ban_reason": "xxx",    (string) Provided for backwards compatibility, always "manually added"
  "ban_duration": n,      (numeric) The ban duration, in seconds
  "time_remaining": n     (numeric) The time remaining until the ban expires, in seconds
}

Examples

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

Bitcoin Cash Node Daemon version v29.1.1-3c2c3de

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