TRON HTTP API

TRON Mainnet 和 Nile 除 JSON-RPC 外，还提供原生 HTTP API。其他链和网络没有通用 HTTP API 入口。

免 Endpoint 调用只适用于部分 JSON-RPC 方法，不适用于 TRON HTTP API。原生 HTTP API 始终需要配置匹配的 http_api Endpoint 和 route。

当前控制台只能直接配置 JSON-RPC 路由。使用 TRON HTTP API 前，请确认平台管理员已经创建 http_api Endpoint，并将它加入目标 Gateway 的 HTTP API route；否则会返回 503 No available Endpoint。

地址与鉴权

Mainnet 主机为 tron-httpapi.<gateway-domain>，Nile 主机为 tron-testnet-httpapi.<gateway-domain>。优先从控制台复制完整地址。

Path Key：

https://tron-httpapi.<gateway-domain>/<app_api_key>/wallet/getnowblock

Bearer 模式不在路径中放 Key：

curl -X POST 'https://tron-httpapi.<gateway-domain>/wallet/getnowblock' \
  -H 'Authorization: Bearer <app_api_key>' \
  -H 'Content-Type: application/json' \
  --data '{}'

若同时提供 Path Key 与 Bearer，两者必须一致。不要把 API Key 放入 Query、Cookie 或其他 Header。

请求

入口只接受 GET、POST，并开放以下路径族：

curl -X POST 'https://tron-httpapi.<gateway-domain>/<app_api_key>/wallet/getnowblock' \
  -H 'Content-Type: application/json' -d '{}'
 
curl -X POST 'https://tron-httpapi.<gateway-domain>/<app_api_key>/walletsolidity/getnowblock' \
  -H 'Content-Type: application/json' -d '{}'
 
curl 'https://tron-httpapi.<gateway-domain>/<app_api_key>/v1/accounts/<address>/transactions?limit=20'

每个路径族至少还需要一个后续路径段。/walletpbft/*、其他路径族和 DELETE/PUT/PATCH 不支持。

请求正文与 Query 参数会原样转发；重复 Query 参数及其顺序会保留。只向上游转发 Accept、Content-Type 请求头，上游供应商 Key 由 Endpoint 配置注入。

响应与错误

上游状态码和正文保持不变。响应只透传 Content-Type、Cache-Control、ETag、Last-Modified、Expires 和 Retry-After。

Gateway 生成的 Wallet/Solidity 错误格式：

{"Error":"Rate limit exceeded."}

TronGrid v1 错误格式：

{"Success":false,"Error":"Rate limit exceeded.","StatusCode":429}

常见状态码：400 请求错误、401 鉴权失败、404 Gateway 或路径不存在、405 方法不允许、408 读取超时、413 请求过大、429 限流、502 Endpoint 尝试失败、503 Gateway 禁用或无可用 Endpoint、500 内部错误。429 会返回 Retry-After。

限流与故障切换

HTTP API 的限流额度与 JSON-RPC 独立。默认 safe_only 路由策略会对连接或配置失败、3xx 以及上游 401、403、429 执行故障切换，但不会在结果不确定时重放 TRON POST。只有路由明确配置为 idempotent 时，才会对 408、425、5xx、响应中断和超时重试。

HTTP API 不使用 JSON-RPC 缓存。