# chainquery Bitcoin Core listbanned RPC

> chainquery Bitcoin Core listbanned RPC is a paid API for AI agents from x402.chainquery.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the list of currently banned peer IPs and subnets from chainquery's independent Bitcoin Core full node via pay-per-call x402.

## Facts

- Endpoint: GET https://x402.chainquery.com/v1/rpc/listbanned
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainquery-bitcoin-core-listbanned-rpc-42975b84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V8Gu97Psfrolj7p48qEJL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainquery-bitcoin-core-listbanned-rpc-42975b84
```

Example prompt: Show me all the currently banned peer IPs and subnets on chainquery's Bitcoin full node.

## When to prefer this

Choose this endpoint when you need to inspect the current peer ban list of an independent Bitcoin Core full node without setting up your own node or obtaining a traditional API key — ideal for lightweight, pay-per-use blockchain infrastructure queries via x402.

## Known failure modes

- Payment failure — x402 payment of $0.005 USDC not processed, returning 402 Payment Required
- Node unavailable — chainquery's full node is temporarily down, returning 503
- Invalid params — malformed JSON in the params query parameter, returning 400
- Rate limiting — too many rapid requests from the same client
- Empty result — no peers are currently banned, returning an empty array

## How this service works

chainquery Bitcoin RPC: pay-per-call Bitcoin Core over x402, no API key. Currently banned peer IPs and subnets from chainquery's independent full node. Bitcoin Core listbanned.

## Output

A JSON array of banned peer entries, each containing the address (IP or subnet), the time the ban was created, the ban duration, and the reason for the ban, as returned by Bitcoin Core's listbanned RPC method.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "params": {
       "type": "string",
       "description": "optional: JSON-encoded array of positional RPC params"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "description": "listbanned result"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainquery-bitcoin-core-listbanned-rpc-42975b84/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.chainquery.com](https://www.zero.xyz/host/x402.chainquery.com/llms.txt)