什么是 Node API
Node API 让您的后端可以访问我们的 TRON 全节点。它就是 java-tron 节点本身的 API:/wallet/* 和 /walletsolidity/* 下相同的 HTTP 方法,以及相同的 gRPC 服务,通过密钥访问,配额和每秒限制由您的套餐决定。
通过节点构建和广播交易,在您这边签名。您的私钥始终不离开您的服务器。
地址
与 java-tron 一样,
/walletsolidity/* 只根据已固化(已确认)的区块作答。节点在这两个路径下提供的每个方法均可使用。
HTTP 接受 GET 和 POST:使用 GET 时节点读取查询字符串,使用 POST 时读取 JSON 请求体——二者不会同时读取。
方法名区分大小写,与 java-tron 一致:/wallet/getaccount,但 /wallet/getReward。
当请求带有 Accept-Encoding: gzip 时,1 KB 及以上的响应会以 gzip 压缩。大多数 HTTP 库默认会发送该请求头;使用 curl 时,请加上 --compressed。
获取密钥
1
登录
在 tronrental.com 注册或登录。
2
选择套餐
打开控制台 → Node API。开通 7 天免费试用(充值满 $5 后解锁),或购买套餐,费用从您的账户余额中支付。参见套餐与计费。
3
创建端点
添加端点:填写名称,并可选设置 IP 白名单。每个端点就是一个独立的密钥。密钥只显示一次——请复制并妥善保存。参见端点与密钥。
4
发起第一次调用
在
TRON-PRO-API-KEY 请求头中发送密钥。X-Node-API-WU 响应头表示本次调用消耗了多少配额单位——这次为 1。参见配额单位。
包含内容
/wallet/*和/walletsolidity/*下的全部节点方法,以及 gRPC 服务protocol.Wallet和protocol.WalletSolidity的一元方法。- 密钥可放在请求头、URL 路径或 gRPC 元数据中。
- 最多 10 个端点(视套餐而定),每个都有独立的密钥、IP 白名单和用量计数器。
- 新区块固定计价:距链头 20 个以内的区块无论大小均为 3 WU,其回执为 2 WU。
- Start、Growth 和 Pro 套餐为软限制:配额用完后,请求仍可正常使用,超出配额的用量按超额用量计费。
- 支持 CORS,浏览器应用可以直接调用节点。
不包含的内容
以下内容不属于节点 API,因此 Node API 不提供:- 地址历史和索引数据——某个地址的转账、按地址查询的 TRC-20 转账、合约事件查询(如
/v1/...和/event/...这类路径)。对它们的请求会得到404 not_found。要跟踪转账,请读取区块及其回执——参见代码示例中的“监听 USDT”示例。 - JSON-RPC(
/jsonrpc、eth_*方法)未开启。 - 需要私钥的方法,如
gettransactionsign或easytransferbyprivate。节点不提供这些方法;对它们的请求会得到404 method_not_found,且不计费。请在您这边签名。 - 其他 gRPC 服务以及 gRPC 服务器反射。参见 gRPC。
响应头
通过 gRPC 时,相同的值位于尾部元数据中:
x-node-api-wu、x-node-api-mode、retry-after,被拒绝时还有 x-node-api-reason。
后续步骤
端点与密钥
如何传递密钥、IP 白名单、浏览器应用。
代码示例
使用 TronWeb、tronpy、curl 和 grpcurl 接入、发送 USDT 和监听 USDT。
套餐与计费
配额、限制、超额用量、试用和续费。
限制与错误
所有拒绝代码、gRPC 状态和降级模式。