数据洞察

概述

使用场景

1. 新增账户：使用 getDailyNewAccounts 获取每日新增地址（newAddressSeen）。
2. 活跃账户：使用 getActiveStatistic 获取每日活跃地址数量。
3. 日交易量：使用 getTransactionStatistics 和 getTriggerStatistic 查询交易量与合约调用量。
4. 交易类型分布：使用 getTransactionStatistics 和 getTransferStatistics 分析交易类型或细分分布。
5. 热门代币：使用 getHotSearch 查询趋势代币及其价格与活跃度。
6. 热门合约：使用 getHotSearch、getTriggerStatistic 或 getTop10 查询热门合约。
7. 按交易量排名的前十大账户：使用 getTop10，选择对应类别（如按交易量）。
8. 质押 TRX 最多的账户：使用 getTop10 或对账户列表按冻结/质押金额排序（根据 API 类别设置）。

MCP 服务器

• 前置条件：[TronScan MCP 使用指南](https://mcpdoc.tronscan.org)

工具说明

getDailyNewAccounts

• API：getDailyNewAccounts — 获取每日新增账户数据（默认最近 15 天，最大支持 2000 天）
• 数据来源：返回 newAddressSeen（每日新增地址）。该数据为活动代理指标，非精确的日活用户数（DAU）。
• 适用场景：用户询问“新增账户”、“每日新增地址”或“每日新增账户数”时。
• 注意事项：若用户询问 DAU / 日活用户，请先声明：“此 API 返回的是每日新增地址，非精确的 DAU；可作为参考，但不可作为准确日活数据呈现。”
• 输入参数：可选起始时间、结束时间或天数。
• 输出结果：每日新增账户序列。

getTransactionStatistics

• API：getTransactionStatistics — 获取交易统计数据（总交易量、代币交易量等）
• 适用场景：用户询问“交易数量”、“交易量”或“网络活跃度”时。
• 输出结果：聚合后的交易量与代币交易总量。

getTransferStatistics

• API：getTransferStatistics — 按代币类型获取转账统计数据
• 适用场景：用户询问“转账分布”或“交易类型分布”时。
• 输出结果：按代币类型的转账活动情况。

getTriggerStatistic

• API：getTriggerStatistic — 在指定时间段内获取每日合约调用数据
• 适用场景：用户询问“每日合约调用次数”或“智能合约活跃度”时。
• 输入参数：时间范围。
• 输出结果：每日调用次数。

getTop10

• API：getTop10 — 获取排行榜前十（支持多时间/类别维度）
• 适用场景：用户询问“前十大账户”、“交易最多”、“质押最多 TRX”等排名类问题时。
• 输入参数：类别、时间范围（依 API 规定）。
• 输出结果：所选维度下的前十大列表。

getHotSearch

• API：getHotSearch — 获取热门代币与合约（含交易指标与价格数据）
• 适用场景：用户询问“热门代币”、“热门合约”或“TRON 上的热门趋势”时。
• 输出结果：带有价格与活跃度的热门代币/合约列表。

getHomepageData

• API：getHomepageData — 获取首页数据（TPS、节点数、概览、冻结资产、TVL 等）
• 适用场景：用户询问“TRON 网络概览”或“网络整体情况”时。
• 输出结果：TPS、节点数量、网络概览、TVL、冻结资产等。

getCurrentTps

• API：getCurrentTps — 获取当前 TPS、最新区块高度及历史最高 TPS
• 适用场景：用户询问“当前 TPS”或“网络吞吐量”时。
• 输出结果：currentTps、latest block、max TPS。

getTriggerAmountStatistic

• API：getTriggerAmountStatistic — 获取按日期分布的合约调用量
• 适用场景：用户询问“合约调用量按日期分布”时。
• 输出结果：按日期划分的合约调用量分布。

getContractCallerStatisticOverview

• API：getContractCallerStatisticOverview — 获取合约调用者统计（默认最近 7 天）
• 适用场景：用户询问“谁在调用合约”或“调用者概况”时。
• 输出结果：调用者数量、调用频率及合约调用者的聚合统计。

getActiveStatistic

• API: getActiveStatistic — 按日/周/月获取 TRON 区块链上的活跃账户数据
• 使用场景：用户询问“活跃账户”、“日活跃用户”、“DAU”、“WAU”、“MAU”或“活跃地址数量”时
• 输入参数：type（必填：DAY | WEEK | MONTH），startTimestamp（必填：毫秒时间戳）
• 返回结果：指定时间粒度的活跃账户数据集

getDailyAvgBlockSize

• API: getDailyAvgBlockSize — 获取 TRON 的每日平均区块大小
• 使用场景：用户询问“区块大小趋势”或“平均区块大小”时
• 输入参数：可选 days

getDailyTransactionNum

• API: getDailyTransactionNum — 获取 TRON 的交易趋势数据
• 使用场景：用户询问“每日交易数量”或“交易趋势”时
• 输入参数：可选 type，days

getDefiTvl

• API: getDefiTvl — 获取 TRON 上每日 DeFi 总锁仓价值（TVL）统计数据
• 使用场景：用户询问“DeFi TVL”、“总锁仓价值”或“TVL 趋势”时
• 输入参数：可选 type，startTime，endTime，project

getEnergyDailyStatistic

• API: getEnergyDailyStatistic — 按合约排名获取每日能源消耗统计
• 使用场景：用户询问“哪个合约消耗最多能源”或“每日能源排名”时
• 输入参数：day（必填），可选 limit

getEnergyStatistic

• API: getEnergyStatistic — 按天/月/季度获取能源消耗分布
• 使用场景：用户询问“能源消耗趋势”或“网络能源使用随时间变化”时
• 输入参数：startTimestamp，endTimestamp（均必填），type（必填）；可选 size

getMultipleChainQuery

• API: getMultipleChainQuery — 查询 TRON 地址在其他区块链上的对应信息
• 使用场景：用户询问“跨链地址”、“该地址是否也在以太坊上存在”或“多链查询”时
• 输入参数：address（必填）

getNetStatistic

• API: getNetStatistic — 获取每日/每月/每季度的带宽消耗情况
• 使用场景：用户询问“带宽使用趋势”或“网络带宽统计”时
• 输入参数：startTimestamp，endTimestamp（均必填）；可选 type，limit

getStatsOverview

• API: getStatsOverview — 获取 TRON 每日统计数据：转账、账户、资源、代币等
• 使用场景：用户询问“TRON 每日统计数据概览”或“整体网络状态”时
• 输入参数：可选 days

getTotalBlockchainSize

• API: getTotalBlockchainSize — 获取链上累计区块大小
• 使用场景：用户询问“区块链大小”或“TRON 链有多大”时
• 输入参数：可选 days

getTransactionNum

• API: getTransactionNum — 获取每日累计交易数量
• 使用场景：用户询问“总交易数”或“累计交易数量”时
• 输入参数：可选 days

getAcquisitionCostStatistic

• API: getAcquisitionCostStatistic — 获取能量和带宽资源获取成本数据
• 使用场景：用户询问“能量价格”、“带宽成本”或“资源获取成本趋势”时
• 输入参数：可选 startTimestamp，endTimestamp，limit

故障排查

• MCP 连接失败：若出现“连接被拒绝”，请检查设置 > 扩展中 TronScan MCP 是否已正确连接。
• API 调用频率限制 / 429 错误：未使用 API Key 时，TronScan API 存在调用次数和频率限制。如遇限流或 429 错误，请前往 [TronScan 开发者 API](https://tronscan.org/#/developer/api) 申请 API Key，然后将其添加至 MCP 配置中并重试。

空值或异常结果

请检查时间范围参数；部分 API 有默认限制（例如 getDailyNewAccounts 最大支持 2000 天）。

注意事项

• getDailyNewAccounts 返回的是 newAddressSeen（每日新增地址数）——这是一个活动代理指标，而非精确的 DAU。当用户要求 DAU 或日活跃用户时，必须首先声明此为新增地址指标，不得将其呈现为精确的 DAU 数据。
• 按“质押 TRX”排名的前十大账户，请使用 getTop10 并配合正确的类别（详见 TronScan API 列表中的类别值）。
• 若需一个综合展示“当前网络动态”的仪表板，建议组合使用：getHomepageData + getCurrentTps + getHotSearch + getTop10 + getTransactionStatistics。