TronGrid API指南：TRON开发者节点接入
TronGrid是开发者无需操作全节点即可访问TRON区块链数据的标准方式。它公开账户余额、交易历史、合约触发器和事件日志的 REST 端点——直接通过 HTTP 或通过TronWeb 使用。
本指南涵盖设置、身份验证、常见端点和生产最佳实践。
TronGrid 与自托管节点
| 方法 | 优点 | 缺点 |
|---|---|---|
| TronGrid | 快速设置，维护基础设施 | 速率限制，对提供商的依赖 |
| 拥有全节点 | 无外部限制 | 运营负担、同步时间、硬件 |
大多数申请从TronGrid开始；大交易量交易所通常运行私有节点。
注册和 API 密钥
2.创建账户→仪表板→创建API密钥
- 在 header 中使用 key:
TRON-PRO-API-KEY: <your-key>
如果没有密钥，激进的轮询可能会受到限制。
端点
| 网络 | 基本网址 |
|---|---|
| 主网 | https://api.trongrid.io |
| Shasta 测试网 | https://api.shasta.trongrid.io |
TronWeb配置：
const tronWeb = new TronWeb({
fullHost: 'https://api.trongrid.io',
headers: { 'TRON-PRO-API-KEY': 'your-key' },
});
常见的 REST 操作
获取账户信息
GET /v1/accounts/{address}
返回 TRX 余额、资源（能量/带宽）和 TRC-20 代币余额。
请参阅查询TRC-20余额API。
通过ID获取交易
GET /v1/transactions/{txid}
请参阅验证交易API。
广播交易
POST /wallet/broadcasttransaction
正文包含来自 TronWeb 的签名交易 JSON。
触发智能合约
POST /wallet/triggersmartcontract
用于读/写合约调用 - 触发智能合约。
完整参考：TRON HTTP API。
速率限制和可靠性
生产模式：
- 缓存不可变数据（旧块、已确认的交易）
- 429 响应的指数退避
- 如果允许，每个服务层有多个 API 密钥
- 用于[付款检测]的 Webhook/轮询混合体(/zh/articles/accept-usdt- payments-api/)
事件和日志
TronGrid 支持合约事件的事件插件查询——对于 USDT 存款监听器很有用。 TronWeb 包装器：事件监听器。
安全性{#security}
- API 密钥是秘密——环境变量，而不是前端包
- 仅使用安全密钥在服务器端签署交易
- 广播前验证地址
Shasta 开发工作流程
1.Shasta端点+测试密钥
- 水龙头TRX
- 通过TronBox部署合约
- 使用新地址升级到主网
生产部署技巧
跨服务运行多个 API 密钥以实现配额隔离。缓存不可变数据（合约 ABI、经过验证的来源）。对 429 响应使用指数退避。对于关键任务支付检测，请考虑专用全节点或高级TronGrid层。
端点选择指南
使用/wallet/*进行交易构建和广播。使用 /v1/* 来索引历史记录和事件。错误地混合它们 - 例如，每秒轮询 getaccount 进行支付检测而不是事件 API - 浪费配额并增加延迟。在设计审核期间将每个产品功能映射到正确的端点系列。
相关指南 {#相关}
常见问题解答
什么是TronGrid？
TronGrid 是 TRON 的托管 API 服务，提供对完整节点数据（账户、交易、区块和智能合约）的 HTTP 访问，而无需运行您自己的节点。
我需要 TronGrid 的 API 密钥吗？
免费套餐有限制。生产应用程序应注册 TRON-PRO-API-KEY 以提高速率限制和可靠性。
TronGrid 和TronScan API 一样吗？
TronScan 提供用于人类可读数据的浏览器 API。 TronGrid是来自TRON基金会生态系统的面向节点的基础设施。许多应用程序都使用两者。
TronGrid可以签署交易吗？
不需要，您使用TronWeb+私钥或TronLink进行本地签名； TronGrid 广播签名的交易。
如果 TronGrid 宕机了会发生什么？
实施重试、状态页面监控，并考虑关键系统的后备全节点。
感谢你的反馈——帮助我们改进文档。