TronGrid V1 API 概览

TronGrid V1 API 是 TronGrid 在标准 TRON 节点 HTTP API 之外提供的一组扩展 API。它面向高频查询和业务集成场景，预先索引链上数据，并把常见的账户历史、Token 转账、合约事件、内部交易、区块统计等查询封装成直接可用的 HTTP 接口。

如果你只需要构建、签名或广播交易，通常使用 FullNode HTTP API。如果你需要查询已固化状态，使用 Solidity HTTP API。如果你需要账户历史、事件日志、TRC-20 转账、合约交互历史或聚合统计，TronGrid V1 API 通常比直接扫描区块更合适。

TronGrid V1 API 覆盖 Mainnet、Shasta 测试网和 Nile 测试网。生产环境请求需要携带 API key，并根据业务流量选择合适的配额和限流配置。TronGrid 节点服务和扩展 API 的整体说明，见 TronGrid。

V1 API 分类

分类	入口	主要用途
API Key 与网络配置	API Key	创建和管理 API key，查看网络入口、安全设置、限流策略
账户与交易	账户与交易	查询账户信息、账户交易历史、TRC-20 转账、内部交易、Token 余额
TRC-10 资产	资产（TRC-10）	按 ID、名称、发行方查询 TRC-10 资产，或列出链上 TRC-10 资产
合约	合约	查询合约交易历史、合约内部交易、TRC-20 Token 信息和持有人余额
事件	事件	按交易、合约、区块或最新区块查询智能合约事件日志
区块	区块	查询 TronGrid 预索引的区块聚合统计数据
MCP API	MCP API	通过 Model Context Protocol 把 TRON 查询能力提供给 AI 客户端和自定义 Agent
TRON AI Agent 技能	TRON AI Agent 技能	使用预置技能通过自然语言查询 TRON 链上数据

常见使用场景

查询账户历史

使用账户与交易接口查询某个地址的交易历史、TRC-20 转账、内部交易或 Token 余额。相比直接从区块中逐笔解析，V1 API 已经按地址维度建立索引，更适合账户历史、资产流水和数据看板类查询。

查询合约事件

使用事件接口按交易 ID、合约地址、区块号或最新区块查询 Event Log。它适合监听 TRC-20 / TRC-721 转账、合约业务事件和 DApp 后端状态同步。

查询合约和 Token 数据

使用合约接口查询合约交易历史、内部交易、TRC-20 Token 信息和持有人余额。使用 TRC-10 资产接口查询链上 TRC-10 资产列表和资产详情。

接入 AI Agent

使用 MCP API 或 TRON AI Agent 技能，可以把 TronGrid 的链上查询能力接入 Claude、Cursor 或自定义 Agent。适合通过自然语言完成账户画像、交易分析、Token 查询、区块查询和数据洞察。

网络入口

网络	Base URL
Mainnet	https://api.trongrid.io
Shasta 测试网	https://api.shasta.trongrid.io
Nile 测试网	https://nile.trongrid.io

API key

生产环境请求应携带 API key，用于配额管理和限流控制。未携带 API key 的请求可能被严格限流或拒绝。创建、配置和保护 API key 的说明见 API Key，限流和退避策略见速率限制。

客户端安全提醒

TRON API 把 HTTP API 的 Content-Type 设为 application/json 已降低 XSS 风险，但客户端仍应把所有 API 返回数据视为外部输入。将 API 返回内容渲染到 UI 前，建议先做 HTML 编码；visible = true 返回 Base58Check 地址的场景也应遵循同样规则。