公共错误说明（TronScan）
错误契约 = HTTP 状态码。TronScan 错误返回体尚未统一，故本文仅规范 HTTP 状态码，不给统一错误体结构。
1. HTTP 状态码
| 状态 | 含义 | 可重试 | 说明 |
|---|---|---|---|
200 OK | 成功 | — | 解析 body |
400 Bad Request | 请求无效 | 否 | 参数格式/缺失；部分接口返回 {"message":"..."} 错误体 |
401 Unauthorized | 缺少 / 无效 Key | 否 | 强制 Key 接口无 Key 调用返回（具体接口见其「接口与鉴权」节） |
403 Forbidden | 被拒 / 无权限 | 否 | API Key 无权限或被封 |
404 Not Found | 路径 / 资源不存在 | 否 | — |
410 Gone | 资源已下线 / 接口废弃 | 否 | 接口已永久停用，不可继续使用，调用方需要迁移至替代接口 |
429 Too Many Requests | 触发限流 | 是 | 退避后重试；按响应头 Retry-After 秒数退避（限流为全局，见 API Keys 文档） |
5xx | 服务端错误 | 是 | 退避重试 |
2. 重要现状（agent 须知）
- 部分参数违规被静默处理：如
limit超上限、start+limit过大，不报错而是截断/忽略并返回200+ 数据。agent 不能依赖”报错”来发现参数问题，须按文档约束自行校验。 - 错误返回体未统一：不同接口出错时返回体形态不一——可能为空、
{"message":"..."}（如account/wallet缺参数返回400+{"message":"some parameters are invalid or out of range"}）、或其他结构；暂不规范统一错误体，以 HTTP 状态码为准。
3. 空结果 ≠ 错误
| 场景 | 正确响应 | agent 行为 |
|---|---|---|
| 列表无命中 | 200 + 数据数组 []、total 仍返回 | 正常空列表，判空不报错 |
4. 引用方式
各接口文档「错误」章节不重复本表，只写：① 本接口特有错误场景（如有）；② “通用 HTTP 状态码见公共错误说明”。
最后更新于: