TronGrid

通过 TronGrid 访问 TRON FullNode、SolidityNode、JSON-RPC、gRPC 和预索引扩展 API。

TronGrid 是 TRON 网络的托管节点服务,作用类似以太坊生态中的 Infura 或 Alchemy:开发者无需自行部署和维护节点,就可以通过 HTTPS 或 gRPC endpoint 连接 TRON 网络,读取链上状态、构建和广播交易,并接入常用工具链。

除标准节点 endpoint 外,TronGrid 还提供一组预索引扩展 API,用于查询标准节点接口不直接返回的账户历史、Token 转账、合约事件和内部交易等数据。

TronGrid 的核心能力可以分为两类:

能力说明
节点服务提供 FullNode HTTP、SolidityNode HTTP、JSON-RPC 和 gRPC endpoint,用于交易构建、广播、链上状态读取和工具链接入。
扩展 API提供 TronGrid V1 API,用于查询账户历史、TRC-20 转账、合约事件、内部交易、Token 余额和区块统计等预索引数据。

主网站和控制台入口:

资源链接
TronGrid 网站https://www.trongrid.io
Shasta 测试网https://www.trongrid.io/shasta
API key / 配额管理登录 TronGrid 控制台后管理
📘

前置阅读


节点服务

作为托管节点服务,TronGrid 代理 TRON 节点的标准接口:

API 类型典型用途
FullNode HTTP API构建交易、广播交易、读取最新链头状态
SolidityNode HTTP API读取已固化交易、账户和区块状态
JSON-RPC API接入 ethers、web3.js、viem 等以太坊兼容工具链
gRPC API服务端程序直接调用 TRON 原生 gRPC 接口

FullNode 和 SolidityNode 的选择取决于是否需要最终状态。交易构建和广播通常使用 FullNode;交易确认、余额对账和已固化区块读取应使用 SolidityNode。详细选型见 FullNode 与 SolidityNode 选择指南。

常用网络 endpoint 见 网络。gRPC 调用示例见 通过 gRPC 调用 TRON。


扩展 API

TronGrid V1 API 是 TronGrid 在标准节点 API 之外提供的预索引查询层。它适合按账户、合约、Token、事件或区块维度查询历史数据,避免调用方自行扫描和解析每个区块。

常见查询目标包括:

查询目标参考入口
V1 API 分类与入口TronGrid V1 API 概览
账户状态和交易历史账户与交易
TRC-20 / TRC-721 转账历史通过账户地址获取合约交易信息
合约事件日志事件
内部交易通过地址获取内部交易

扩展 API 是索引服务,不等同于节点共识层本身。需要最终状态时,应使用确认参数、分页游标、本地去重和必要的已固化状态校验。


AI Agent 接入

除直接的 HTTP 和 gRPC 调用外,TronGrid 还为 AI Agent 和命令行工作流提供更上层的接入方式。它们封装的是同一套底层 API,因此共用同一份 API key、网络和限流策略。

接入方式说明入口
MCP 服务器托管的 Model Context Protocol 服务器,把 TRON 的查询和操作能力封装为标准化 MCP 工具,供 Claude、Cursor 和自定义 Agent 等客户端调用。MCP 服务器
AI Agent 技能独立技能包中的预置工作流(账户分析、通证扫描、交易解码等),需由支持的 Agent 客户端单独加载。AI Agent 技能
CLItrongrid-cli,用于 TRON 读取类查询的命令行工具,并提供面向 Agent 和脚本的 --json 模式。CLI

API key

生产环境调用 TronGrid 应配置 API key。API key 用于身份识别、配额统计、限流控制和安全策略配置,不代表链上账户权限,也不会替应用签名交易。

API key 的创建、网络入口和请求头格式,见 API Key。安全设置(Origin、User-Agent、API 允许列表、JWT 等)见 安全设置。


Rate limit

TronGrid 会按 API key、账户、IP、接口类型和时间窗口限制请求量。被限流时,接口可能返回 429 或 403。客户端应使用退避、缓存、分页和断点续扫策略,不应高频轮询同一地址或同一区块范围。

限流维度、错误响应、重试策略和提高配额流程,见 TronGrid 速率限制。


与自建节点的关系

TronGrid 和自建节点不是互斥关系。TronGrid 适合快速接入、测试网开发、备用 endpoint 和预索引历史查询;自建节点适合高可控的生产链路、内部审计、专用索引和自定义节点配置。

维度TronGrid自建节点
运维成本无需自行同步和维护节点需要部署、同步、监控和升级
标准节点 API通过托管 endpoint 调用由本地 java-tron 节点直接提供
历史查询V1 API 提供预索引查询需要自建索引器或逐块扫描
可控性受服务策略、配额和限流影响可控制节点配置、数据保留和访问策略

托管 RPC、自建节点和索引器的取舍,见 RPC 与索引器服务商。


相关资源