{"skill":{"slug":"trongrid-token-list","displayName":"trongrid-token-list","summary":"Browse and rank TRC-20 and TRC-10 tokens on TRON with price, volume, market cap, holder count, and category filters. Use when a user wants to discover tokens...","description":"---\nname: trongrid-token-list\ndescription: \"Browse and rank TRC-20 and TRC-10 tokens on TRON with price, volume, market cap, holder count, and category filters. Use when a user wants to discover tokens, see token rankings, find trending tokens, compare tokens by market cap, or explore categories like stablecoins and DeFi tokens on TRON.\"\nmetadata:\n  version: \"1.0.0\"\n  mcp-server: trongrid\n---\n\n# Token List\n\nList and profile TRC-20 and TRC-10 tokens on TRON using TronGrid MCP tools.\n\n# MCP Server\n- **Prerequisite**: [TronGrid MCP Guide](https://developers.tron.network/reference/mcp-api)\n\n> **Scope note**: TronGrid has no \"list all TRC-20\" endpoint. TRC-20 queries require known contract addresses — either provided by the user or drawn from the built-in reference list below. TRC-10 assets can be listed in full via `listAllAssets`.\n\n## Built-in TRC-20 Reference Addresses\n\nUse these when the user asks for general token rankings without specifying addresses:\n\n| Token | Symbol | Contract Address                     | Category   |\n|-------|--------|--------------------------------------|------------|\n| Tether | USDT   | `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t` | Stablecoin |\n| USDD | USDD | `TXDk8mbtRbXeYuMNS83CfKPaYYT8XWv9Hz` | Stablecoin |\n| SUN   | SUN    | `TSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S` | DeFi       |\n| JUST  | JST    | `TCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy9` | DeFi       |\n| WINkLink | WIN  | `TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7` | Oracle     |\n| USDJ  | USDJ   | `TMwFHYXLJaRUPeW6421aqXL4ZEzPRFGkGT` | Stablecoin |\n| BitTorrent | BTT | `TAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp4` | Utility   |\n\n## Instructions\n\n### Step 1: Resolve Token Addresses\n\n- If the user provides contract addresses → use them directly\n- If the user asks for general rankings or categories → use the built-in reference list above, filtered by the requested category\n\n### Step 2: Fetch TRC-20 Token Data\n\nFor each contract address, call in parallel:\n\n1. `getTrc20Info` — Name, symbol, decimals, total supply\n2. `getTrc20TokenHolders` (limit=5) — Top holders and total holder count estimate\n3. `getContractInfo` — Contract settings, energy limit, origin address\n4. `getContractTransactions` (limit=20) — Recent transaction activity\n\n### Step 3: Fetch TRC-10 Asset List\n\nFor TRC-10 tokens (when requested):\n\n1. `getPaginatedAssetIssueList` (limit=20-50) — Paginated TRC-10 list with supply, issuer, precision\n2. `getAssetIssueByName` or `getAssetIssueById` — For specific TRC-10 lookups\n\n### Step 4: Rank and Categorize\n\nSince TronGrid returns no market price data, rank by available on-chain signals:\n\n- **By holder count** (from `getTrc20TokenHolders`)\n- **By recent activity** (transaction count from `getContractTransactions`)\n- **By total supply** (from `getTrc20Info`)\n\n**By Category**:\n- Stablecoins: USDT, USDD, USDJ\n- DeFi: SUN, JST, WIN\n- Infrastructure / Utility: BTT\n\n### Step 5: Compile Token List\n\n```\n## TRON Token Overview\n\n### TRC-20 Tokens\n| Token | Symbol | Total Supply | Holders (est.) | Recent Txs | Category |\n|-------|--------|-------------|----------------|-----------|----------|\n\n### TRC-10 Tokens (Top by Supply)\n| Token | ID | Total Supply | Precision | Issuer |\n|-------|----|-------------|-----------|--------|\n\n> Note: Price and market cap data are not available via TronGrid. For market data, consult an external source.\n```\n\n## Quality Signals\n\nWhen evaluating tokens, flag these patterns:\n- Low holder count + high supply = potential wash trading or abandoned token\n- Growing recent transaction count = active adoption\n- Unverified contract (no ABI) + mint/pause functions = caution\n- For \"best\" or \"quality\" queries, weigh holder count and tx activity heavily\n\n## Error Handling\n\n| Error | Cause | Resolution |\n|-------|-------|------------|\n| `getTrc20Info` returns empty | Invalid or non-TRC-20 contract address | Skip token, note \"Not a valid TRC-20 contract\" |\n| `getTrc20TokenHolders` returns empty | Contract has no holders or very new token | Note \"No holder data available\" |\n| User asks for token not in reference list | Unknown token | Ask user for the contract address |\n| TRC-10 list very large | Thousands of TRC-10 assets exist | Use `getPaginatedAssetIssueList` with limit=20-50 |\n\n## Examples\n\n- [Top TRON tokens by market cap](examples/top-tron-tokens.md)\n- [DeFi tokens on TRON](examples/defi-tokens.md)\n","tags":{"latest":"1.0.3"},"stats":{"comments":0,"downloads":604,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":4},"createdAt":1773294876972,"updatedAt":1778491848315},"latestVersion":{"version":"1.0.3","createdAt":1773915411258,"changelog":"- Documentation clarified: emphasizes TronGrid cannot list all TRC-20 tokens automatically and relies on a built-in list of major TRC-20 contracts.\n- Added a table with reference TRC-20 token addresses and categories to use for default queries.\n- Instructions restructured to reflect use of only on-chain data (no price/market cap from TronGrid).\n- Token ranking logic updated: now based on holder count, recent activity, and supply, not market metrics.\n- Quality signals, error handling, and output format simplified and aligned for only on-chain data sources.","license":"MIT-0"},"metadata":null,"owner":{"handle":"greason","userId":"s176mhh3c31n267h3brgrreh1x83jhx8","displayName":"greason","image":"https://avatars.githubusercontent.com/u/12513158?v=4"},"moderation":null}