# QuickNode REST Gateway (x402) — Generic Network/Path

> QuickNode REST Gateway (x402) — Generic Network/Path 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).

Paid x402-gated proxy to QuickNode REST endpoints for any supported blockchain network and REST path, billed at $10 USDC per call.

## Facts

- Endpoint: POST https://x402.quicknode.com/%7Bnetwork%7D/v1/%7BrestPath%7D
- 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/x402-quicknode-com-3d4432e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ote6R7dckrzjJnat4qQUP

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 x402-quicknode-com-3d4432e2 -d '<json body>'
```

Example prompt: Call the QuickNode x402 gateway for ethereum-mainnet and run eth_blockNumber with no params — pay the $10 USDC per-call fee — and tell me the latest block number.

## When to prefer this

Use this endpoint when you need pay-per-call access to QuickNode's blockchain REST/JSON-RPC infrastructure across multiple networks without managing API keys or subscriptions — especially suited for agent workflows that make sporadic, multi-chain RPC calls and want to pay with USDC via the x402 protocol.

## Known failure modes

- Payment failure: x402 payment not accepted, returns 402 with payment requirements
- Invalid network: unsupported network slug in path returns 404 or error
- Invalid JSON-RPC method: unrecognized method returns JSON-RPC error -32601
- Malformed params: incorrect params array returns JSON-RPC error -32602
- Rate limit or node error: upstream QuickNode node unavailable returns 5xx
- Invalid jsonrpc version: must be '2.0' or request is rejected

## How this service works

Paid gateway to QuickNode REST endpoints across supported networks.

## Output

A JSON-RPC 2.0 response object containing the result of the requested blockchain method call (e.g. block number, transaction receipt, contract return value) or a JSON-RPC error object if the call failed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-quicknode-com-3d4432e2/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)