API 参考

BlockReq 支持标准 Ethereum JSON-RPC 2.0 规范。所有方法均可通过 HTTPS 和 WSS 端点访问。

基础 URL

HTTPS: https://{chain-slug}.blockreq.com/v1/rpc/public
WSS:   wss://{chain-slug}.blockreq.com/v1/rpc/public

需要更高速率限制？ 创建私有端点 获取专属 API Key。

请求格式

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

响应格式

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1234567"
}

立即试用

# 无需 API Key — 使用公开端点
curl -X POST https://eth-mainnet.blockreq.com/v1/rpc/public \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

可用方法

查看详细方法文档：

• EVM JSON-RPC 方法 — 完整的 EVM 方法列表及 RU 消耗
• Beacon Chain API — 以太坊信标链 REST API

速率限制

请求根据您的套餐限速（例如 Free: 100 req/s, Growth: 500 req/s, Premium: 5,000 req/s）。超出限制将收到 HTTP 429 响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "Rate limit exceeded"
  }
}

错误码

HTTP 状态码	含义
401	API Key 缺失或无效
402	RU 余额不足
429	超出速率限制
502	上游节点错误

WebSocket 订阅

通过 WSS 连接获取实时数据：

const ws = new WebSocket("wss://eth-mainnet.blockreq.com/v1/rpc/public");

ws.onopen = () => {
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    method: "eth_subscribe",
    params: ["newHeads"],
    id: 1
  }));
};

ws.onmessage = (event) => {
  console.log(JSON.parse(event.data));
};