Stablecoin

Overview

Tool	Function	Use Case
getStableCoinOverview	Stablecoin overview	Supply, holder count for a stablecoin
getStableCoinTotalSupply

Total supply | Current total circulating supply of all stablecoins | | getStableCoinTotalSupplyChange | Supply change trend | Historical chart of total supply changes | | getStableCoinTopHolders | Top holders | Top stablecoin holders ranked by USDT/USDC/USDD/TUSD | | getStableCoinHolderChange | Holder count trend | Daily holder count change over time | | getStableCoinHolderBalanceOverview | Market cap distribution | Total market cap distribution across all stablecoins | | getStableCoinDistribution | Holder distribution | Holder distribution for a specific stablecoin | | getStableCoinDistributionChange | Distribution change | Historical change in holding distribution | | getStableCoinTransferAmount | Transfer volume trend | Stablecoin transfer amount changes over time | | getStableCoinBigAmount | Large transactions | Large stablecoin transactions (swap, liquidity, loan, etc.) | | getStableCoinBlackList | Blacklist | Frozen addresses and amounts | | getStableCoinPoolInfo | Pool detail | All stablecoin liquidity pool details | | getStableCoinPoolOverview | Pool overview | Basic info for a specific pool | | getStableCoinPoolChange | Pool liquidity change | Liquidity change chart for a pool | | getStableCoinPoolTrend | Pool trend | Trend data for pool liquidity changes | | getStableCoinTvl | Pool TVL | Stablecoin TVL distribution across pools | | getStableCoinTokenSupplyTurnover | Supply & turnover trend | Supply and circulation trend for a specific stablecoin | | getStableCoinKeyEvents | Key events | Mint/burn/freeze and other major operations |

Use Cases

1. 1. Stablecoin overview: Use getStableCoinOverview (optionally with tokenAddress) for supply and holder count; getStableCoinTotalSupply for all stablecoins combined.
2. Supply trends: Use getStableCoinTotalSupplyChange for total supply history; getStableCoinTokenSupplyTurnover for a single stablecoin's supply and turnover trend.
3. Holder analysis: Use getStableCoinTopHolders for top holders (sort by USDT/USDC/USDD/TUSD); getStableCoinHolderChange for holder count trend; getStableCoinHolderBalanceOverview for market cap distribution; getStableCoinDistribution and getStableCoinDistributionChange for holding concentration.
4. Transfer activity: Use getStableCoinTransferAmount for transfer volume trends; getStableCoinBigAmount for large transaction monitoring (filter by types: 0=all, 1=in, 2=out, 3=swap, 4=add liquidity, 5=remove liquidity, 6=deposit, 7=loan, 8=repayment, 9=withdrawal).
5. Blacklist / risk: Use getStableCoinBlackList for frozen addresses; getStableCoinKeyEvents for mint/burn/freeze events.
6. Liquidity pools: Use getStableCoinPoolInfo for all pools; getStableCoinPoolOverview, getStableCoinPoolChange, getStableCoinPoolTrend for a specific pool; getStableCoinTvl for TVL distribution.

MCP Server

• - Prerequisite: TronScan MCP Guide

Tools

getStableCoinOverview

• - API: getStableCoinOverview — Get basic overview for stablecoins (supply, holders)
• Use when: User asks for "stablecoin overview", "USDT supply", or general stablecoin stats.
• Input: Optional tokenAddress.

getStableCoinTotalSupply

• - API: getStableCoinTotalSupply — Get current total circulating supply for all stablecoins
• Use when: User asks for "total stablecoin supply" or "how much USDT/USDC/USDD is on TRON".
• Input: None required.

getStableCoinTotalSupplyChange

• - API: getStableCoinTotalSupplyChange — Get chart data for total supply changes
• Use when: User asks for "stablecoin supply trend" or "supply history".
• Input: Optional startTime, endTime (in seconds).

getStableCoinTopHolders

• - API: getStableCoinTopHolders — Get top stablecoin holders ranking
• Use when: User asks for "top stablecoin holders" or "who holds the most USDT".
• Input: Optional sort (USDT | USDC | USDD | TUSD), direction (1=asc, 2=desc), viewContract (1=include, 2=exclude).

getStableCoinHolderChange

• - API: getStableCoinHolderChange — Get stablecoin holder count change over time
• Use when: User asks for "stablecoin holder growth" or "holder count trend".
• Input: Optional startDay, endDay (yyyy-MM-dd).

getStableCoinHolderBalanceOverview

• - API: getStableCoinHolderBalanceOverview — Get market cap distribution across all stablecoins
• Use when: User asks for "stablecoin market cap distribution" or "USDT vs USDC market share".
• Input: None required.

getStableCoinDistribution

• - API: getStableCoinDistribution — Get holder distribution for a specific stablecoin
• Use when: User asks for "USDT holder distribution" or "stablecoin concentration".
• Input: Optional token (token address).

getStableCoinDistributionChange

• - API: getStableCoinDistributionChange — Get holding distribution change chart for a specific stablecoin
• Use when: User asks for "distribution change over time".
• Input: Optional token (token address).

getStableCoinTransferAmount

• - API: getStableCoinTransferAmount — Get stablecoin transfer amount trend
• Use when: User asks for "stablecoin transfer volume" or "transfer activity trend".
• Input: Optional startTime, endTime (seconds), type (set to "addLine" for line chart data).

getStableCoinBigAmount

• - API: getStableCoinBigAmount — Get large stablecoin transactions (up to 50 records)
• Use when: User asks for "large stablecoin transfers", "whale transactions", or "stablecoin swap/loan activity".
• Input: types (required: 0=all, 1=in, 2=out, 3=swap, 4=add liquidity, 5=remove liquidity, 6=deposit, 7=loan, 8=repayment, 9=withdrawal); optional: address, txUsd, txAmount, relatedAddress, relatedToken, startTime, endTime, limit (max 50), sortBy (time|amount|usd), asc.

getStableCoinBlackList

• - API: getStableCoinBlackList — Get stablecoin blacklist (frozen addresses)
• Use when: User asks for "stablecoin blacklist", "frozen addresses", or "sanctioned USDT addresses".
• Input: Optional tokenAddress, blackAddress, sort (1=amount, 2=time), direction, start, limit.

getStableCoinPoolInfo

• - API: getStableCoinPoolInfo — Get all stablecoin liquidity pool details
• Use when: User asks for "stablecoin pools" or "liquidity pool list".
• Input: None required.

getStableCoinPoolOverview

• - API: getStableCoinPoolOverview — Get basic info for a specific stablecoin pool
• Use when: User asks for "pool overview" or provides a pool address.
• Input: Optional pool (pool contract address).

getStableCoinPoolChange

• - API: getStableCoinPoolChange — Get liquidity change chart for a pool
• Use when: User asks for "pool liquidity changes".
• Input: Optional pool (pool address).

getStableCoinPoolTrend

• - API: getStableCoinPoolTrend — Get pool liquidity trend data
• Use when: User asks for "pool trend" or "historical pool liquidity".
• Input: Optional pool, startTimestamp, endTimestamp (milliseconds; start after 2022-11-21).

getStableCoinTvl

• - API: getStableCoinTvl — Get stablecoin TVL distribution across liquidity pools
• Use when: User asks for "stablecoin TVL" or "how much stablecoin is in DeFi pools".
• Input: Optional token (token address).

getStableCoinTokenSupplyTurnover

• - API: getStableCoinTokenSupplyTurnover — Get supply and circulation trend for a specific stablecoin
• Use when: User asks for "USDT supply trend", "stablecoin turnover", or supply/circulation history for USDD/USDC/TUSD.
• Input: Optional tokenAddress (USDD | USDC | TUSD), startTime, endTime (seconds).

getStableCoinKeyEvents

• - API: getStableCoinKeyEvents — Get key stablecoin events (mint/burn/freeze/major operations)
• Use when: User asks for "stablecoin mint events", "USDT freeze events", or "key stablecoin operations".
• Input: Optional start, limit, sort (1=amount, 2=time), direction, operatorAddress, startTime, endTime, startAmount, endAmount; per-token event type filters: usdt, usdc, usdd, tusd (comma-separated event types).

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.

Notes

• - For a stablecoin dashboard, combine: getStableCoinOverview + getStableCoinTotalSupply + getStableCoinTopHolders + getStableCoinPoolInfo.
• INLINECODE93 requires types parameter; use types: "0" for all transaction types.
• Time parameters vary by tool: some use seconds (startTime/endTime), others use milliseconds (startTimestamp/endTimestamp). Check per-tool notes.