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):

getTrc20Info — Name, symbol, decimals, standard, total supply
getContractInfo — Deployer, energy settings, creation time
getContract — ABI (for standard compliance check), bytecode

TRC-10:

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

getContractTransactions — Recent contract interactions, transaction patterns
getEventsByContractAddress — Transfer events, approvals, etc.
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" |

trongrid-token-scanner