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
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" |
Examples
- Scan USDT token on TRON
- Token safety check
1---2name: trongrid-token-scanner3description: 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.4---56# Token Scanner78In-depth analysis of any specific TRC-20 or TRC-10 token — supply, market data, holder distribution, contract details, transaction activity, and safety scoring.910# MCP Server11- **Prerequisite**: [TronGrid MCP Guide](https://developers.tron.network/reference/mcp-api)1213## Instructions1415### Step 1: Identify the Token1617- **TRC-20**: Identified by contract address (e.g., `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t` for USDT)18- **TRC-10**: Identified by numeric token ID or name1920### Step 2: Fetch Token Metadata2122**TRC-20** (run in parallel):231. `getTrc20Info` — Name, symbol, decimals, standard, total supply242. `getContractInfo` — Deployer, energy settings, creation time253. `getContract` — ABI (for standard compliance check), bytecode2627**TRC-10**:281. `getAssetByIdentifier` or `getAssetByName` — Name, abbreviation, total supply, precision, issuer, issue time, URL, frozen supply2930### Step 3: Analyze Holder Distribution3132For TRC-20, call `getTrc20TokenHolders`:33- Top holders and balances34- Concentration: what % do top 10/50/100 holders control35- Identify if whale addresses are exchanges or known entities3637### Step 4: Examine Activity38391. `getContractTransactions` — Recent contract interactions, transaction patterns402. `getEventsByContractAddress` — Transfer events, approvals, etc.413. Analyze: daily volume, active addresses, organic vs. bot patterns4243### Step 5: Fetch Market Data4445Web search for off-chain data:46- Price (USD, BTC), 24h volume, market cap, FDV47- Exchange listings, price trends4849### Step 6: Safety Assessment5051Evaluate across dimensions:5253| Dimension | Check | Tool |54|-----------|-------|------|55| Contract verified | ABI available? | `getContract` |56| Holder concentration | Top 10 hold >80%? | `getTrc20TokenHolders` |57| Liquidity | Volume vs. market cap ratio | Web search |58| Permissions | mint/pause/blacklist functions? | ABI analysis |59| Activity | Organic or artificial patterns? | `getContractTransactions` |6061### Step 7: Compile Token Report6263```64## Token Report: [Name] ([Symbol])6566### Basic Info67- Contract/ID: [address or ID]68- Standard: TRC-20 / TRC-1069- Decimals: [X]70- Issuer: [address]71- Issue Date: [date]7273### Supply & Market74- Total Supply: [amount]75- Price: $[X.XXXX]76- Market Cap: $[X.XX M/B]77- 24h Volume: $[X.XX M]7879### Holders80- Total: [count]81- Top 10 Concentration: [X.X%]82- Largest Holder: [address] ([X.X%])8384### Activity85- Daily Transactions: ~[count]86- 7-day Trend: [increasing/stable/decreasing]8788### Safety Score: [Low/Medium/High Risk]89- Contract Verified: [Yes/No]90- Holder Concentration: [Low/Medium/High]91- Liquidity: [Good/Fair/Poor]92- Red Flags: [list if any]93```9495## Error Handling9697| Error | Cause | Resolution |98|-------|-------|------------|99| Token not found | Invalid contract address or token ID | Ask user to verify; suggest searching by name with `getAssetByName` |100| No holders data | New token or API limitation | Note "Holder data unavailable", continue with other metrics |101| ABI unavailable | Unverified contract | Flag as risk factor, proceed with transaction-based analysis |102| TRC-10 name collision | Multiple TRC-10 tokens share same name | Use `getAssetByIdentifier` with numeric ID instead |103| No market data | Unlisted token | Report on-chain data only, note "Not listed on price aggregators" |104105## Examples106107- [Scan USDT token on TRON](examples/scan-usdt-token.md)108- [Token safety check](examples/token-safety-check.md)