公共网络与鉴权说明(TronScan)
TronScan 各接口的 Base URL 与鉴权方式一致,故统一在此说明;接口页不重复,只给 METHOD path 并引用本文。
1. 网络与 Base URL
| 网络 | Base URL | API Key |
|---|---|---|
| 主网 Mainnet | https://apilist.tronscanapi.com | 必须 |
| Shasta 测试网 | https://shastapi.tronscan.org | 不支持 |
| Nile 测试网 | https://nileapi.tronscan.org | 不支持 |
主网调用必须使用 API Key。无 Key 匿名调用时的限制极其严格(QPS 极低,极易触发限制),且部分接口在无 Key 时可能会直接请求失败并返回
401(本文档不明确列出受限的接口清单)。档位定义见 §3。
2. 鉴权
- 鉴权 Header:
TRON-PRO-API-KEY: <your-key>(主网建议携带;测试网不接受 Key)。 - 注入:请求头携带,示例中以
<your-key>占位——文档与示例不得写入真实 Key。
3. API Key 四档(档位定义)
| 档 | 含义 |
|---|---|
| 强制 Required | 不带 Key 无法调用 |
| 强烈推荐/必须 Required | 常规调用必须携带 Key;无 Key 时 QPS 极低,且部分接口可能会直接失败 |
| 可选 Optional | 带不带都可 |
| 不支持 Unsupported | 该网络不接受 Key |
4. 申请与限流
- API Key 申请、注入方式、全局配额见 TronScan 开发者后台 / API Keys 文档。
- 限流为全局(非单接口);
429触发时按Retry-After退避(见 公共错误说明)。
5. 引用方式
各接口文档「接口与鉴权」节不重复本文,只写 METHOD path + 一行 “Base URL 与鉴权见公共网络与鉴权说明”。本接口网络/档位与上表一致时无需复述;有例外才单独注明。
最后更新于: