Data Insights
Overview
| Tool | Function | Use Case |
|---|
| getDailyNewAccounts | Daily new accounts | Daily new addresses (newAddressSeen), up to 2000 days |
| getTransactionStatistics |
Tx statistics | Total tx, token tx volume, aggregates |
| getTransferStatistics | Transfer stats | Transfer activity by token type |
| getTriggerStatistic | Contract triggers | Daily contract call count |
| getTop10 | Top10 rankings | Multiple dimensions (time, category) |
| getHotSearch | Hot tokens/contracts | Hot tokens and contracts with metrics |
| getHomepageData | Homepage data | TPS, node count, overview, TVL, frozen |
| getCurrentTps | Current TPS | Current TPS, latest height, historical max TPS |
| getTriggerAmountStatistic | Trigger by date | Contract call volume distribution by date |
| getContractCallerStatisticOverview | Caller overview | Contract caller stats (default 7d) |
| getActiveStatistic | Active accounts | Active account count per day/week/month |
| getDailyAvgBlockSize | Avg block size | Daily average block size |
| getDailyTransactionNum | Daily tx trend | Transaction trend data |
| getDefiTvl | DeFi TVL | Daily DeFi TVL statistics |
| getEnergyDailyStatistic | Energy daily stats | Daily energy consumption ranked by contract |
| getEnergyStatistic | Energy distribution | Energy consumption by day/month/quarter |
| getMultipleChainQuery | Cross-chain query | TRON address mapping on other chains |
| getNetStatistic | Bandwidth stats | Bandwidth consumption per day/month/quarter |
| getStatsOverview | Stats overview | Daily stats: transfers, accounts, resources, tokens |
| getTotalBlockchainSize | Blockchain size | Cumulative on-chain size |
| getTransactionNum | Cumulative txs | Cumulative transactions per day |
| getAcquisitionCostStatistic | Resource cost | Energy and bandwidth acquisition cost |
Use Cases
- 1. New accounts: Use
getDailyNewAccounts for daily new addresses (newAddressSeen). - Active accounts: Use
getActiveStatistic for daily active addresses. - Daily transaction count: Use
getTransactionStatistics and getTriggerStatistic for tx and contract call volume. - Transaction type distribution: Use
getTransactionStatistics and getTransferStatistics for type/segment distribution. - Hot tokens: Use
getHotSearch for trending tokens with price and activity. - Hot contracts: Use
getHotSearch and getTriggerStatistic or getTop10 for hot contracts. - Top accounts by tx count: Use
getTop10 with appropriate category (e.g. by tx count). - Top account by staked TRX: Use
getTop10 or account list sorted by frozen/stake (category as per API).
MCP Server
Tools
getDailyNewAccounts
- - API:
getDailyNewAccounts — Get daily new account data (default last 15 days, max 2000 days) - Data source: Returns
newAddressSeen (daily new addresses). This is an activity proxy, not precise DAU. - Use when: User asks for "new accounts", "daily new addresses", or "new accounts per day".
- If user asks for DAU / daily active: First declare that "this API returns daily new addresses, not precise DAU; it can be used as a reference but must not be presented as exact DAU".
- Input: Optional start/end or day count.
- Response: Daily new account series.
getTransactionStatistics
- - API:
getTransactionStatistics — Get transaction statistics (total tx, token tx volume, etc.) - Use when: User asks for "transaction count", "tx volume", or "network activity".
- Response: Aggregated tx and token volume.
getTransferStatistics
- - API:
getTransferStatistics — Get transfer statistics by token type - Use when: User asks for "transfer distribution" or "tx type distribution".
- Response: Transfer activity by type.
getTriggerStatistic
- - API:
getTriggerStatistic — Get daily contract trigger data in a time range - Use when: User asks for "contract calls per day" or "smart contract activity".
- Input: Time range.
- Response: Daily trigger count.
getTop10
- - API:
getTop10 — Get Top10 rankings (multiple time/category dimensions) - Use when: User asks for "top 10 accounts", "most tx", "most staked TRX", or similar rankings.
- Input: Category, time range (as per API).
- Response: Top 10 list for selected dimension.
getHotSearch
- - API:
getHotSearch — Get hot tokens and contracts (trading metrics and price data) - Use when: User asks for "hot tokens", "hot contracts", or "trending on TRON".
- Response: Hot tokens/contracts with price and activity.
getHomepageData
- - API:
getHomepageData — Get homepage data (TPS, node count, overview, frozen, TVL, etc.) - Use when: User asks for "TRON overview" or "network summary".
- Response: TPS, nodes, overview, TVL, frozen.
getCurrentTps
- - API:
getCurrentTps — Get current TPS, latest block height, and historical max TPS - Use when: User asks for "current TPS" or "network throughput".
- Response: currentTps, latest block, max TPS.
getTriggerAmountStatistic
- - API:
getTriggerAmountStatistic — Get contract call volume distribution by date - Use when: User asks for "contract call distribution by date".
- Response: Contract call volume distribution by date.
getContractCallerStatisticOverview
- - API:
getContractCallerStatisticOverview — Get contract caller statistics (default last 7 days) - Use when: User asks for "who is calling contracts" or "caller overview".
- Response: Caller count, call frequency, and aggregate stats for contract callers.
getActiveStatistic
- - API:
getActiveStatistic — Get active account data on the TRON blockchain by day/week/month - Use when: User asks for "active accounts", "daily active users", "DAU", "WAU", "MAU", or "active address count".
- Input:
type (required: DAY | WEEK | MONTH), startTimestamp (required: milliseconds). - Response: Active account dataset for the selected time granularity.
getDailyAvgBlockSize
- - API:
getDailyAvgBlockSize — Get daily average block size on TRON - Use when: User asks for "block size trend" or "average block size".
- Input: Optional
days.
getDailyTransactionNum
- - API:
getDailyTransactionNum — Get transaction trend data on TRON - Use when: User asks for "daily transaction count" or "tx trend".
- Input: Optional
type, days.
getDefiTvl
- - API:
getDefiTvl — Get daily DeFi TVL statistics on TRON - Use when: User asks for "DeFi TVL", "total value locked", or "TVL trend".
- Input: Optional
type, startTime, endTime, project.
getEnergyDailyStatistic
- - API:
getEnergyDailyStatistic — Get daily energy consumption statistics ranked by contract - Use when: User asks for "which contracts consume the most energy" or "daily energy ranking".
- Input:
day (required), optional limit.
getEnergyStatistic
- - API:
getEnergyStatistic — Get energy consumption distribution by day/month/quarter - Use when: User asks for "energy consumption trend" or "network energy usage over time".
- Input:
startTimestamp, endTimestamp, type (all required); optional size.
getMultipleChainQuery
- - API:
getMultipleChainQuery — Query a TRON address's corresponding info on other blockchains - Use when: User asks for "cross-chain address", "is this address on Ethereum too", or "multi-chain lookup".
- Input:
address (required).
getNetStatistic
- - API:
getNetStatistic — Get bandwidth consumption per day/month/quarter - Use when: User asks for "bandwidth usage trend" or "network bandwidth statistics".
- Input:
startTimestamp, endTimestamp (required); optional type, limit.
getStatsOverview
- - API:
getStatsOverview — Get daily TRON stats: transfers, accounts, resources, tokens - Use when: User asks for "TRON daily statistics overview" or "overall network stats".
- Input: Optional
days.
getTotalBlockchainSize
- - API:
getTotalBlockchainSize — Get cumulative on-chain block size - Use when: User asks for "blockchain size" or "how large is the TRON chain".
- Input: Optional
days.
getTransactionNum
- - API:
getTransactionNum — Get cumulative transaction count per day - Use when: User asks for "total transactions" or "cumulative tx count".
- Input: Optional
days.
getAcquisitionCostStatistic
- - API:
getAcquisitionCostStatistic — Get Energy and Bandwidth resource acquisition cost data - Use when: User asks for "energy price", "bandwidth cost", or "resource acquisition cost trend".
- Input: Optional
startTimestamp, endTimestamp, limit.
Troubleshooting
- - MCP connection failed: If you see "Connection refused", verify TronScan MCP is connected in Settings > Extensions.
- API rate limit / 429: TronScan API has call count and frequency limits when no API key is used. If you encounter rate limiting or 429 errors, go to TronScan Developer API to apply for an API key, then add it to your MCP configuration and retry.
Empty or unexpected results
Check time range parameters; some APIs have default limits (e.g. getDailyNewAccounts max 2000 days).
Notes
- -
getDailyNewAccounts returns newAddressSeen (daily new addresses)—an activity proxy, not precise DAU. When the user asks for DAU / daily active, you must first declare that this is a new-address metric and must not be presented as exact DAU. - Top accounts by "staked TRX" use
getTop10 with the appropriate category (see TronScan API list for category values). - For a single dashboard of "what's happening", combine:
getHomepageData + getCurrentTps + getHotSearch + getTop10 + getTransactionStatistics.
数据洞察
概览
| 工具 | 功能 | 使用场景 |
|---|
| getDailyNewAccounts | 每日新增账户 | 每日新增地址(newAddressSeen),最多2000天 |
| getTransactionStatistics |
交易统计 | 总交易量、代币交易量、聚合数据 |
| getTransferStatistics | 转账统计 | 按代币类型的转账活动 |
| getTriggerStatistic | 合约触发 | 每日合约调用次数 |
| getTop10 | Top10排名 | 多维度(时间、类别) |
| getHotSearch | 热门代币/合约 | 热门代币和合约及其指标 |
| getHomepageData | 首页数据 | TPS、节点数、概览、TVL、冻结量 |
| getCurrentTps | 当前TPS | 当前TPS、最新高度、历史最高TPS |
| getTriggerAmountStatistic | 按日期触发量 | 按日期的合约调用量分布 |
| getContractCallerStatisticOverview | 调用者概览 | 合约调用者统计(默认7天) |
| getActiveStatistic | 活跃账户 | 每日/每周/每月活跃账户数 |
| getDailyAvgBlockSize | 平均区块大小 | 每日平均区块大小 |
| getDailyTransactionNum | 每日交易趋势 | 交易趋势数据 |
| getDefiTvl | DeFi TVL | 每日DeFi TVL统计 |
| getEnergyDailyStatistic | 能量每日统计 | 按合约排名的每日能量消耗 |
| getEnergyStatistic | 能量分布 | 按日/月/季度的能量消耗 |
| getMultipleChainQuery | 跨链查询 | 其他链上的TRON地址映射 |
| getNetStatistic | 带宽统计 | 按日/月/季度的带宽消耗 |
| getStatsOverview | 统计概览 | 每日统计:转账、账户、资源、代币 |
| getTotalBlockchainSize | 区块链大小 | 链上累计大小 |
| getTransactionNum | 累计交易量 | 每日累计交易量 |
| getAcquisitionCostStatistic | 资源成本 | 能量和带宽获取成本 |
使用场景
- 1. 新账户:使用 getDailyNewAccounts 获取每日新增地址(newAddressSeen)。
- 活跃账户:使用 getActiveStatistic 获取每日活跃地址。
- 每日交易量:使用 getTransactionStatistics 和 getTriggerStatistic 获取交易和合约调用量。
- 交易类型分布:使用 getTransactionStatistics 和 getTransferStatistics 获取类型/分段分布。
- 热门代币:使用 getHotSearch 获取带价格和活动数据的热门代币。
- 热门合约:使用 getHotSearch 和 getTriggerStatistic 或 getTop10 获取热门合约。
- 交易量最高账户:使用 getTop10 并选择适当类别(例如按交易量)。
- 质押TRX最多账户:使用 getTop10 或按冻结/质押排序的账户列表(类别按API)。
MCP服务器
工具
getDailyNewAccounts
- - API:getDailyNewAccounts — 获取每日新增账户数据(默认最近15天,最多2000天)
- 数据来源:返回 newAddressSeen(每日新增地址)。这是一个活动代理指标,非精确DAU。
- 使用时机:用户询问新账户、每日新增地址或每天新账户数。
- 如果用户询问DAU/日活跃:首先声明此API返回每日新增地址,非精确DAU;可作为参考但不得呈现为精确DAU。
- 输入:可选的开始/结束时间或天数。
- 响应:每日新增账户序列。
getTransactionStatistics
- - API:getTransactionStatistics — 获取交易统计(总交易量、代币交易量等)
- 使用时机:用户询问交易数量、交易量或网络活动。
- 响应:聚合的交易和代币量。
getTransferStatistics
- - API:getTransferStatistics — 按代币类型获取转账统计
- 使用时机:用户询问转账分布或交易类型分布。
- 响应:按类型的转账活动。
getTriggerStatistic
- - API:getTriggerStatistic — 获取时间范围内的每日合约触发数据
- 使用时机:用户询问每日合约调用或智能合约活动。
- 输入:时间范围。
- 响应:每日触发次数。
getTop10
- - API:getTop10 — 获取Top10排名(多时间/类别维度)
- 使用时机:用户询问前10账户、最多交易、最多质押TRX或类似排名。
- 输入:类别、时间范围(按API)。
- 响应:所选维度的前10列表。
getHotSearch
- - API:getHotSearch — 获取热门代币和合约(交易指标和价格数据)
- 使用时机:用户询问热门代币、热门合约或TRON趋势。
- 响应:带价格和活动数据的热门代币/合约。
getHomepageData
- - API:getHomepageData — 获取首页数据(TPS、节点数、概览、冻结量、TVL等)
- 使用时机:用户询问TRON概览或网络摘要。
- 响应:TPS、节点、概览、TVL、冻结量。
getCurrentTps
- - API:getCurrentTps — 获取当前TPS、最新区块高度和历史最高TPS
- 使用时机:用户询问当前TPS或网络吞吐量。
- 响应:currentTps、最新区块、最高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地址在其他区块链上的对应信息
- 使用时机:用户询问跨链地址、此