速率限制

TronGrid 使用 API key、每日配额和请求频率限制来保护服务稳定性。生产环境请求应携带 TRON-PRO-API-KEY，并在客户端实现重试、退避和缓存策略。

具体配额和 QPS 可能随套餐、网络、接口类型和服务策略调整。不要把固定数值硬编码到业务逻辑中；请以 TronGrid 控制台和当前服务返回为准。

限流维度

TronGrid 可能从多个维度限制请求：

常见限流行为

错误响应

被限流时，V1 API 可能返回类似结构：

{
  "success": false,
  "error": "The key exceeds the frequency limit",
  "statusCode": 429
}

标准节点 HTTP API 的代理接口可能返回更简单的错误信息：

{
  "Error": "The key exceeds the frequency limit"
}

客户端不要依赖单一错误文案判断限流。建议同时检查 HTTP 状态码、响应体中的错误字段，以及请求是否携带了正确的 API key。

重试和退避策略

处理限流时，建议遵循以下原则：

1. 对 429 使用指数退避，并加入随机抖动，避免多个实例同时重试。
2. 对 403 先检查 API key、安全设置和是否触发临时封锁，不要立即高频重试。
3. 对读接口增加缓存。账户状态、Token 信息、区块统计等数据通常不需要毫秒级刷新。
4. 按 TRON 出块节奏设计轮询。TRON 约每 3 秒出一个新区块，轮询最新区块或事件时不应明显快于这个节奏。
5. 对历史数据使用分页和断点续扫，不要在单个请求中拉取过大范围。

提高 API Key 访问量

如果现有 API key 的访问量无法满足业务需求，可以向 TronGrid 申请更高配额或定制方案。当前流程如下：

1. 在 TronGrid 注册并登录账号。
2. 打开 TronGrid Price 页面。
3. 找到 Custom Price 模块，点击 Contact US。
4. 提交业务信息、预期请求量、主要接口类型、目标网络和使用场景。
5. TronGrid 团队会根据业务需求、流量规模和服务资源进行评估，并调整对应账号或 API key 的访问配置。

申请前建议先整理以下信息，便于评估：

配额提升不是自动生效流程，最终结果以 TronGrid 团队评估和实际配置为准。

降低请求量

常见优化方式：

• 对账户和 Token 元数据做本地缓存。
• 对高频页面请求在后端合并，避免浏览器端直接重复访问 TronGrid。
• 用事件或区块号作为同步游标，只查询新增范围。
• 避免多个服务实例同时扫描同一地址或同一区块范围。
• 为不同业务拆分 API key，便于观察和限制异常流量。

相关资源

• API Key —— 创建 key、选择网络入口、配置请求头
• 安全设置 —— 用允许列表和 JWT 限制 key 的使用范围
• TronGrid V1 API 概览 —— V1 API 分类与典型使用场景
• TronGrid —— TronGrid 节点服务和扩展 API 介绍