API 概述

架构

TheRPC API 遵循 JSON-RPC 2.0 规范并提供：

• 标准 HTTP 和 WebSocket 端点
• 通过 API 密钥进行身份验证
• 统一的响应格式
• 跨网络兼容性

通信协议

HTTP 端点

最适合单个请求和简单集成。在我们的 HTTP/Curl 指南 中查看示例。

https://YOUR_API_ENDPOINT

WebSocket 端点

适用于订阅和实时数据。在 eth_subscribe 中查看订阅示例。

wss://YOUR_API_ENDPOINT

JSON-RPC 格式

请求结构

所有 API 调用都遵循 JSON-RPC 2.0 格式。在我们的 基本操作指南 中查看完整示例：

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

必填字段：

• jsonrpc：版本标识符（始终为 "2.0"）
• method：要调用的 RPC 方法（参见 可用方法）
• params：参数数组（可以为空）
• id：请求标识符

响应格式

所有响应都遵循一致的结构：

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": "0x..."
}

或者在出错的情况下：

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32600,
		"message": "Invalid Request"
	}
}

身份验证

所有请求都需要在 Authorization 头中提供 API 密钥。有关详细设置，请参阅我们的 身份验证指南：

Authorization: Bearer YOUR_API_KEY

方法类别

标准方法

• eth_：以太坊协议方法（eth_blockNumber、eth_getBalance 等）
• net_：网络状态方法（net_version）
• web3_：Web3 实用方法（web3_clientVersion）

高级方法

• debug_：调试功能（debug_traceTransaction）
• trace_：交易跟踪（trace_transaction）
• txpool_：交易池信息（txpool_status）

错误处理

常见错误代码（详细错误处理策略请参见 常见问题解答）：

• -32700：解析错误
• -32600：无效请求
• -32601：方法未找到
• -32602：无效参数
• -32603：内部错误

实施示例

查看我们的特定语言指南，获取实际实施示例：

• JavaScript/TypeScript 指南
• Python 指南
• HTTP/Curl 示例
• 在我们的 工具和 SDK 部分查看所有可用的 SDK

速率限制

有关请求限制和配额的信息，请参阅我们的 速率限制文档。

另请参阅

• 身份验证指南 - 详细认证信息
• 可用方法 - 完整方法列表
• 基本操作 - 常见使用模式
• 常见问题解答 - 常见问题和答案