核心用法
tronscan-token-scanner 是一套针对 TRON 生态系统的链上代币分析工具集，覆盖 TRC10/TRC20/TRC721/TRC1155 全标准，核心功能包括：
1. 代币基础信息查询：通过 getTrc20TokenDetail / getTrc10TokenDetail 获取代币名称、符号、总供应量、持币人数、发行时间、项目描述等元数据
2. 价格与市值追踪：getTokenPrice 获取实时价格（默认 TRX），getFunds 获取 TRX 实时供应量与市值，getTrxVolume 查询历史价格与交易量趋势
3. 持币分布分析：getTrc20TokenHolders / getTrc10TokenHolders 获取持币地址列表及份额，getTokenPositionDistribution 分析筹码集中度（按余额区间统计）
4. 流通与销毁数据：getTrc20TotalSupply 区分流通量与总量，getTurnover 追踪 TRX 的铸造/销毁、周转率及营收统计
5. NFT/多代币库存：getTrc721Inventory / getTrc1155Inventory 支持非同质化及多元代币合约查询
显著优点
- 数据权威性：直接对接 TronScan 官方 MCP 服务器，数据源为 TRON 主网实时区块数据，可信度极高
- 评级系统内置：将原始
level（0-4）转换为易读评级标签（Unknown/Neutral/OK/Suspicious/Unsafe），降低用户理解门槛 - 多维度尽职调查：单工具内整合价格、供应、持仓、流通、安全评级五大维度，无需跨平台跳转
- TRX 原生支持深度：针对 TRON 网络代币 TRX 提供专属工具链（
getFunds、getTurnover、getTrxVolume），覆盖供应趋势、日净变化、销毁统计等细节 - 灵活寻址机制：支持合约地址直接查询，也可配合
tronscan-search通过名称/符号反查地址
潜在局限与风险
| 局限类型 | 具体说明 |
|---------|---------|
| **API 限流** | 无 API Key 时存在调用频次限制，高频查询可能触发 429 错误 |
| **数据时效性** | 链上数据存在标准区块确认延迟，非毫秒级实时 |
| **评级标准黑盒** | `level` 评级算法未公开，仅作参考，不可替代完整合约审计 |
| **价格来源依赖** | 价格数据依赖 TronScan 聚合源，极端行情下可能存在偏差 |
| **标准混淆风险** | TRC20/TRC721/TRC1155 需合约地址，TRC10 需 asset ID，误用会导致查询失败 |
适合人群
- 加密货币投资者：进行代币基本面分析、筹码集中度评估、风险评级筛查
- TRON 生态开发者：调试合约、验证代币元数据、监控发行情况
- 安全研究员：快速识别标记为 Suspicious/Unsafe 的合约，辅助钓鱼合约甄别
- DeFi 分析师：追踪 TRX 及稳定币（如 USDT-TRC20）的流通量、市值、持币分布变化
常规风险提醒
1. 合约地址核实：务必通过官方渠道验证合约地址，避免查询到同名假币
2. 评级非最终结论：OK 评级仅表示通过基础安全检查，不代表合约无漏洞或项目无风险
3. 隐私注意：查询特定地址持仓时，该地址的链上行为可能被记录分析
4. API Key 建议：高频使用场景下建议申请 TronScan Developer API Key 以规避限流