# QuickNode Bitcoin Testnet4 JSON-RPC Proxy

> QuickNode Bitcoin Testnet4 JSON-RPC Proxy is a paid API for AI agents from x402.quicknode.com, paid per call via x402, $10/call, status unknown (last checked 2026-09-15).

Proxies JSON-RPC calls to the Bitcoin Testnet4 network via QuickNode's infrastructure

## Facts

- Endpoint: POST https://x402.quicknode.com/btc-testnet4/
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quicknode-d8569bdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tk_OwuD7qCIGq8hNtA-_E

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 quicknode-d8569bdc -d '<json body>'
```

Example prompt: Call getblockcount on Bitcoin testnet4 to get the current block height — use JSON-RPC 2.0 with an empty params array.

## When to prefer this

Use this endpoint when you need to interact with Bitcoin Testnet4 specifically — for testing Bitcoin scripts, transactions, or integrations before deploying to mainnet. Prefer this over mainnet endpoints when you want to avoid real BTC costs, and over other testnet endpoints (testnet3, signet) when you specifically need testnet4's chain rules. Ideal for developers building and validating Bitcoin applications in a sandboxed environment.

## Known failure modes

- Invalid JSON-RPC method name returns error object with code -32601
- Malformed params array causes parse or invalid params error
- Payment not attached or insufficient USDC triggers 402 Payment Required
- Network congestion or node unavailability may return 503
- Testnet4 node may lag behind or have limited data availability compared to mainnet

## How this service works

JSON-RPC proxy — btc-testnet4

## Output

A standard JSON-RPC 2.0 response object containing the result of the called Bitcoin testnet4 method (e.g. block height integer, transaction object, block hash, or raw hex), along with the matching request id and any error details if the call failed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "jsonrpc",
  "method"
 ],
 "properties": {
  "id": {
   "type": [
    "number",
    "string"
   ],
   "description": "Request identifier"
  },
  "method": {
   "type": "string",
   "description": "JSON-RPC method name (e.g., eth_blockNumber, eth_call)"
  },
  "params": {
   "type": "array",
   "description": "Method parameters"
  },
  "jsonrpc": {
   "type": "string",
   "const": "2.0"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": [
    "number",
    "string"
   ]
  },
  "error": {
   "type": "object",
   "properties": {
    "code": {
     "type": "integer"
    },
    "message": {
     "type": "string"
    }
   }
  },
  "result": {
   "description": "RPC result (type varies by method)"
  },
  "jsonrpc": {
   "type": "string",
   "const": "2.0"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quicknode-d8569bdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.quicknode.com](https://www.zero.xyz/host/x402.quicknode.com/llms.txt)