方案与定价

BlockReq 使用 **Request Counting（请求计数）**计量已认证 HTTP JSON-RPC 与 WSS。付费产品为一次性 Request Pack，不是按月订阅。预付 Requests 用尽后，PAYG 为 $1.90 / 1M Requests。没有套餐专属超售价，也没有最低充值。

方案对比

免费赠送

符合条件的账户可获得 3M Requests，有效期为 30 天：

• 持续 10 / 突发 30 requests per second
• 最大 batch 20，batch 内每个调用都计入每秒速率限制
• 2 个 WSS 连接 / 5 个活跃订阅
• 可用完整链目录，但受 Free entitlement 限制
• Free 不包含 debug_*、trace_*、txpool_*

Crypto API

Crypto API（https://api.blockreq.com/v1/dex）为 On-chain DEX API 和 Wallet API 提供同一把 key 和同一份额度，与 RPC Requests 不共享。Free 套餐卡片会同时显示两项：

Crypto API 调用不消耗 RPC Requests、Request Pack 或钱包余额。开始于 2026-11-04 00:00:00 UTC 之前的周期，到结束前仍按原来的 10 万次。参见计次规则。

debug、trace 与 txpool

付费套餐之间不区分 debug_*、trace_* 或 txpool_*。只要该链路由支持该方法，所有付费套餐都可以调用。Free 赠送不包含这些方法。

Request Pack

每次一次性购买都会创建独立过期的 request lot。即使某个未过期套餐的 Requests remaining 已为零，在套餐到期前它仍可决定 effective tier。

PAYG 与钱包余额

PAYG 是计费模式，不是预付套餐。启用 PAYG 且预付 Requests 用尽后，额外 Requests 按 $1.90 / 1M 应计。**Wallet balance（钱包余额）**用于结算，并与 Requests remaining 分开展示。

额度用完时

账户没有剩余 Requests，也无法用 PAYG 结算（钱包为空、未开启 PAYG 或达到支出上限）时，私有 RPC 端点会在这部分用量结算后改为返回 HTTP 402 Payment Required。正文仍是 JSON-RPC 错误，code 为 -32000；error.data 告诉程序如何充值：

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32000,
    "message": "RPC Endpoint Key credit exhausted: top up to continue. See error.data.topup_url.",
    "data": {
      "reason": "billing_blocked",
      "topup_url": "https://blockreq.com/api/dashboard/billing/onchain",
      "topup_method": "GET",
      "topup_auth": "Authorization: Bearer <account API key (akv1_...)>; the RPC Endpoint Key is not accepted",
      "docs_url": "https://blockreq.com/docs/pricing/plans/#when-credit-runs-out",
      "dashboard_url": "https://blockreq.com/dashboard/billing",
      "payment_method": "onchain_deposit"
    }
  }
}

RPC Endpoint Key 只用来调 RPC，读不到充值地址和余额。程序化充值请用账户 API key（akv1_...，在控制台创建）：以 Authorization: Bearer <账户 API key> 请求 GET https://blockreq.com/api/dashboard/billing/onchain，返回本账户的充值地址（account）、支持的链与稳定币、每次入账的最低额；account 为 null 时，对同一 URL 发 POST 即签发一次地址。若返回 available: false，说明链上充值暂不可用：account 和 chains 为空，POST 会返回 503（onchain_deposits_unavailable），请稍后重试或在控制台充值。向该地址转入不少于最低额的稳定币（例如 Base 上的 USDC），确认后按 1:1 计入钱包（每条链的到账时间见 processingMinutes），端点随即恢复。没有 API key 时，在控制台充值（dashboard_url）。

其他应答不变：无效 Key 是 401；Key 无权使用该端点（IP 白名单、网络、账户被封禁）是 403。402 只出现在 RPC 主机（*-rpc.blockreq.com）上，blockreq.com 本身从不返回 402。

Enterprise

Enterprise 从 500M+ Requests 起，限速、有效期与支持均为定制。请联系销售申请开通。

另见

• Request Counting
• On-chain DEX API