# QuickNode JSON-RPC Proxy — Stacks Testnet

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

Proxies JSON-RPC calls to the Stacks blockchain testnet, enabling read and write interactions with Stacks testnet nodes via QuickNode infrastructure.

## Facts

- Endpoint: POST https://x402.quicknode.com/stacks-testnet/
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quicknode-29493325
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9halczN2oJCx6eKtJhv9Z

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

Example prompt: Call stacks_getInfo on the Stacks testnet via QuickNode to get the current chain tip and network info — use JSON-RPC 2.0 with request id 1 and no params.

## When to prefer this

Use this endpoint when you need to interact with the Stacks blockchain testnet specifically — for development, testing, or staging purposes before deploying to mainnet. Prefer this over Stacks mainnet endpoints when testing smart contracts or transactions without real STX. Choose QuickNode's infrastructure for reliable, low-latency RPC access compared to running your own node.

## Known failure modes

- Invalid JSON-RPC method name returns error code -32601 method not found
- Malformed params array causes -32602 invalid params error
- Payment not included or insufficient returns 402 Payment Required
- Network/node unavailability returns 503 or timeout
- Testnet node out of sync may return stale or inconsistent state

## How this service works

JSON-RPC proxy — stacks-testnet

## Output

A JSON-RPC 2.0 response object containing the result of the requested Stacks testnet method call, including block data, transaction details, account state, or contract execution output depending on the method invoked. Errors are returned as standard JSON-RPC error objects with code and message fields.

## 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-29493325/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)