CLI

概述

trongrid-cli 是通过 TronGrid 查询 TRON 区块链的命令行工具，同时面向人类终端和 AI 编码 Agent。目前覆盖读取类查询（账户、通证、交易、区块等）；写入类和治理类命令计划在后续版本提供。

CLI 调用的是与 HTTP API 相同的 TronGrid endpoint，因此共用同一套网络（mainnet、Shasta、Nile）、API key 和限流策略。

📘

分发渠道

trongrid-cli 目前发布在 npm：https://www.npmjs.com/package/trongrid-cli。

安装

npm install -g trongrid-cli

要求 Node.js ≥ 22。安装后的可执行文件名为 trongrid。

快速入门

# 配置 API key（免费层无需 key 也可使用，但限流更严格）
trongrid auth login

# 默认网络为 mainnet；测试网使用 --network shasta 或 --network nile
trongrid account view TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
trongrid block latest --confirmed

面向 AI Agent 和脚本

--json 标志输出结构化、机器可读的结果，适合管道传入 Agent 和脚本：

trongrid account view TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t --json
trongrid token balance USDT TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9 --json
trongrid tx view <hash> --json

相关资源

• MCP 服务器 —— 通过 Model Context Protocol 将 AI 客户端接入 TRON
• AI Agent 技能 —— 预置的自然语言工作流
• TronGrid V1 API 概览 —— 底层 API 参考