quicknode

Quicknode：为 Agent 提供区块链数据访问

Quicknode 在 77 多个区块链网络上提供高性能 RPC 端点，涵盖 Bankr 支持的所有链：Base、Ethereum、Polygon、Solana 和 Unichain。

两种访问方式：

• API key：创建 Quicknode 账户，获取内置身份验证信息的端点 URL。可完整访问所有产品和设置。
• x402（无需账户）：任何拥有 USDC 的钱包都可以进行身份验证并按请求付费。安装 @quicknode/x402，即可立即开始查询。

x402 访问（推荐用于 Agent）

x402 非常适合自主 Agent。无需注册，也无需 API key。使用 USDC 在 Base、Polygon 或 Solana 上付款。

import { createQuicknodeX402Client } from "@quicknode/x402";

const client = await createQuicknodeX402Client({
  baseUrl: 'https://x402.quicknode.com',
  network: "eip155:84532",   // pay on Base Sepolia (testnet)
  evmPrivateKey: process.env.PRIVATE_KEY,
  preAuth: true,             // pre-authenticates via SIWX for faster payment flow
});

// Pay on Base, query any chain
const res = await client.fetch("https://x402.quicknode.com/ethereum-mainnet", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 1 }),
});

安装：npm install @quicknode/x402

额度价格：

• 测试网：0.01 美元 USDC 可购买 100 个额度
• 主网：10 美元 USDC 可购买 1,000,000 个额度
• 每次成功的 JSON-RPC 响应消耗 1 个额度

完整的 x402 文档：https://x402.quicknode.com/llms.txt

API Key 访问

Quicknode 端点会在 URL 中包含身份验证信息：

https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/

import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

const client = createPublicClient({
  chain: base,
  transport: http(process.env.QUICKNODE_RPC_URL),
});

const block = await client.getBlockNumber();

常见 Agent 操作

检查原生代币余额（EVM）

const balance = await client.getBalance({ address: "0x..." });

或使用原始 RPC：

{ "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x...", "latest"], "id": 1 }

检查 ERC-20 代币余额（EVM）

使用 eth_call 和 ERC-20 的 balanceOf(address) 选择器（0x70a08231）：

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [{
    "to": "0xTOKEN_CONTRACT",
    "data": "0x70a08231000000000000000000000000WALLET_ADDRESS_NO_0x"
  }, "latest"],
  "id": 1
}

获取 Gas 估算值（EVM）

{ "jsonrpc": "2.0", "method": "eth_gasPrice", "params": [], "id": 1 }

检查交易状态（EVM）

{ "jsonrpc": "2.0", "method": "eth_getTransactionReceipt", "params": ["0xTX_HASH"], "id": 1 }

Solana 余额

{ "jsonrpc": "2.0", "method": "getBalance", "params": ["WALLET_PUBKEY"], "id": 1 }

Solana 代币账户

{
  "jsonrpc": "2.0",
  "method": "getTokenAccountsByOwner",
  "params": [
    "WALLET_PUBKEY",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "jsonParsed" }
  ],
  "id": 1
}

Quicknode Marketplace 插件

Quicknode 端点可以通过 Marketplace 插件增强。以下插件与交易 Agent 相关：

• Token API：qn_getWalletTokenBalance 一次调用即可返回某个钱包的所有 ERC-20 余额。无需逐个查询代币合约。
• NFT API：qn_fetchNFTs 可返回某个地址拥有的 NFT 及其元数据。
• Solana Priority Fee API：qn_estimatePriorityFees 根据近期网络活动返回建议的优先费。有助于确保交易快速上链。
• Solana DAS API：通过 getAssetsByOwner 和 searchAssets 等方法查询压缩 NFT、同质化代币和数字资产。
• Metis - Solana Trading API：基于 Jupiter，在 Solana 上进行代币兑换。通过 quoteGet 和 swapPost 端点获取报价并执行兑换。文档：https://www.quicknode.com/docs/solana/metis-overview

查看所有插件：https://marketplace.quicknode.com/

这些插件可用于 API key 端点。请在 Quicknode 控制面板中启用。

支持的网络

Quicknode 支持 Bankr 支持的所有链：

链	x402 网络标识	API Key 文档
Base	base-mainnet	https://www.quicknode.com/docs/base
Ethereum	ethereum-mainnet	https://www.quicknode.com/docs/ethereum
Polygon	polygon-mainnet	https://www.quicknode.com/docs/polygon
Solana	solana-mainnet	https://www.quicknode.com/docs/solana
Unichain	unichain-mainnet	https://www.quicknode.com/docs/unichain

x402 基础 URL：https://x402.quicknode.com/{network-slug}

查看支持链的完整列表：https://www.quicknode.com/chains

错误处理

• 429 请求过多：暂停后重试。使用指数退避。
• 402 需要付款（x402）：额度已用尽。@quicknode/x402 会通过触发新的 USDC 付款自动处理。
• JSON-RPC 错误（例如 -32000）：特定方法的错误。检查参数后重试。

资源

• AI 与 Agent 文档：https://www.quicknode.com/docs/build-with-ai
• 完整 RPC 文档（所有链）：https://www.quicknode.com/docs/llms.txt
• x402 技术详情：https://x402.quicknode.com/llms.txt
• 代码示例（x402）：https://github.com/quiknode-labs/qn-x402-examples
• Marketplace 插件：https://marketplace.quicknode.com
• 完整 Quicknode 技能（含扩展参考资料）：https://github.com/quiknode-labs/blockchain-skills/tree/main/skills/quicknode-skill