trongrid-token-scanner

---

name: trongrid-token-scanner description: "Deep analysis of any specific TRC-20 or TRC-10 token on TRON including supply, price, holder distribution, contract details, activity metrics, and safety assessment. Use when a user asks about a specific token, wants to check token legitimacy, analyze holder concentration, verify token safety, or perform token due diligence." metadata: version: "1.0.0" mcp-server: trongrid

---

Token Scanner

In-depth analysis of any specific TRC-20 or TRC-10 token — supply, market data, holder distribution, contract details, transaction activity, and safety scoring.

MCP Server

Prerequisite: TronGrid MCP Guide

Instructions

Step 1: Identify the Token

TRC-20: Identified by contract address (e.g., TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t for USDT)

TRC-10: Identified by numeric token ID or name

Step 2: Fetch Token Metadata

TRC-20 (run in parallel): 1. getTrc20Info — Name, symbol, decimals, standard, total supply 2. getContractInfo — Deployer, energy settings, creation time 3. getContract — ABI (for standard compliance check), bytecode

TRC-10: 1. getAssetByIdentifier or getAssetByName — Name, abbreviation, total supply, precision, issuer, issue time, URL, frozen supply

Step 3: Analyze Holder Distribution

For TRC-20, call getTrc20TokenHolders:

Top holders and balances

Concentration: what % do top 10/50/100 holders control

Identify if whale addresses are exchanges or known entities

Step 4: Examine Activity

1. getContractTransactions — Recent contract interactions, transaction patterns 2. getEventsByContractAddress — Transfer events, approvals, etc. 3. Analyze: daily volume, active addresses, organic vs. bot patterns

Step 5: Fetch Market Data

Web search for off-chain data:

Price (USD, BTC), 24h volume, market cap, FDV

Exchange listings, price trends

Step 6: Safety Assessment

Evaluate across dimensions:

| Dimension | Check | Tool | |-----------|-------|------| | Contract verified | ABI available? | getContract | | Holder concentration | Top 10 hold >80%? | getTrc20TokenHolders | | Liquidity | Volume vs. market cap ratio | Web search | | Permissions | mint/pause/blacklist functions? | ABI analysis | | Activity | Organic or artificial patterns? | getContractTransactions |

Step 7: Compile Token Report

## Token Report: [Name] ([Symbol])
Basic Info
Contract/ID: [address or ID]
Standard: TRC-20 / TRC-10
Decimals: [X]
Issuer: [address]
Issue Date: [date]
Supply & Market
Total Supply: [amount]
Price: $[X.XXXX]
Market Cap: $[X.XX M/B]
24h Volume: $[X.XX M]
Holders
Total: [count]
Top 10 Concentration: [X.X%]
Largest Holder: [address] ([X.X%])
Activity
Daily Transactions: ~[count]
7-day Trend: [increasing/stable/decreasing]
Safety Score: [Low/Medium/High Risk]
Contract Verified: [Yes/No]
Holder Concentration: [Low/Medium/High]
Liquidity: [Good/Fair/Poor]
Red Flags: [list if any]

Error Handling

| Error | Cause | Resolution | |-------|-------|------------| | Token not found | Invalid contract address or token ID | Ask user to verify; suggest searching by name with getAssetByName | | No holders data | New token or API limitation | Note "Holder data unavailable", continue with other metrics | | ABI unavailable | Unverified contract | Flag as risk factor, proceed with transaction-based analysis | | TRC-10 name collision | Multiple TRC-10 tokens share same name | Use getAssetByIdentifier with numeric ID instead | | No market data | Unlisted token | Report on-chain data only, note "Not listed on price aggregators" |

Examples

Scan USDT token on TRON

Token safety check

Scan USDT token on TRON

Token safety check