文档
定价GitHub控制台

文档

快速开始

在控制台中创建端点，向托管的全节点发送 JSON-RPC 请求。

接收第一个 Webhook

监听测试网地址，并在收到转入交易时获得带签名的通知。

从测试网转账开始

1. 创建端点

在 RpcNode 注册，选择网络和环境，即可获得端点 UUID。

打开控制台

2. 端点 URL

HTTPS JSON-RPC URL 由网络标识（slug）、环境和端点 UUID 组成，与控制台中的取值一致（例如 ethereum + mainnet）。

格式

https://{prefix}-{network}-{environment}.rpcnode.dev/{endpoint-uuid}

示例

https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7

3. 第一个请求

发送标准的 JSON-RPC 2.0 POST 请求，并设置 Content-Type: application/json。

curl 示例

curl https://holy-burned-sky-ethereum-mainnet.rpcnode.dev/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_blockNumber",
  "params": []
}'

速率限制（RPS）

每个端点都有由套餐决定的每秒请求数（RPS）限制。超出时，网关返回 HTTP 429 和 JSON-RPC 错误码 -32005。

计数按端点进行，并在每个 Unix 秒重置（固定 1 秒窗口）。您的限制值显示在控制台和定价页面上。

因 RPS 超限被拒绝的请求不消耗额度，也不计入用量统计。

响应示例

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32005,
    "message": "rps limit exceeded"
  }
}

指南 — 可直接复制使用的示例：在 RpcNode 全节点上读取链顶、获取区块和交易、查询余额，覆盖文档目录中的各主要网络系列。

错误 — RpcNode 网关的常见响应：文档目录中所有网络系列的 HTTP 状态码和 JSON-RPC 错误码。

Public API — 带签名的 HTTP API，涵盖付款、套餐与用量、网络与价格、RPC 端点、地址与交易监听、Webhook、区块事件以及 WebSocket。

网络与方法

通过左侧导航查看网络和 RPC 方法。额度来自计费 API，参数说明来自内容目录。

状态与延迟

RpcNode 网站上公开的链顶探测状态和延迟表，可用于确认各网络是否正常响应。