Token List
Overview
| Tool | Function | Use Case |
|---|
| getTokenList | Token list | Filter by type, sort by price/change/volume/mcap/holders |
| getPricedTokenList |
Priced tokens | All tokens with price data |
| getTrc20TokenDetail | Single token | Full TRC20/721/1155 detail for list item |
| getHotSearch | Hot search | Hot tokens and contracts with metrics and price |
| getSearchBar | Search bar | Popular search results (hot token list) |
Use Cases
- 1. TRC20 Token List: Use
getTokenList with type filter for TRC20; use getPricedTokenList for tokens with price. - Price & 24h Change: Token list and priced list include price and change; use detail for full 24h data.
- 24h Volume: Available in list or detail (e.g.
getTrc20TokenDetail) and in getHotSearch. - Market Cap: In token list/detail and hot search.
- Holder Count: In token list/detail.
- Discover Quality Projects: Sort by volume, market cap, or holders; combine with
getHotSearch for trending.
MCP Server
Tools
getTokenList
- - API:
getTokenList — Get token list with type filter and sort by price/change/volume/holders/mcap - Use when: User asks for "token list", "TRC20 list", or "tokens by volume/mcap".
- Input: type, sort field, order, pagination.
- Response: List of tokens with key metrics.
getPricedTokenList
- - API:
getPricedTokenList — Get all tokens with price data - Use when: User asks for "tokens with price" or "priced token list".
- Response: Tokens with price and related fields.
getTrc20TokenDetail
- - API:
getTrc20TokenDetail — Get TRC20/TRC721/TRC1155 token details (name, symbol, supply, holders, price, etc.) - Use when: User needs full metrics for a token from the list (e.g. 24h volume, holders).
- Input: Contract address.
getHotSearch
- - API:
getHotSearch — Get hot tokens and contracts (trading metrics and price data) - Use when: User asks for "trending tokens" or "hot tokens on TRON".
- Response: Hot tokens/contracts with price and activity metrics.
getSearchBar
- - API:
getSearchBar — Get popular search results (hot token list) - Use when: User asks for "popular tokens" or "search suggestions".
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 "quality projects", combine sort (volume, mcap, holders) with hot search and optional token detail for due diligence.
- List tools support pagination; use limit/skip or page/size as per TronScan MCP API.
- Token list items may include risk fields such as
tokenCanShow and tokenLevel. If a token in the list has tokenCanShow: false or tokenLevel of "3" (Suspicious) / "4" (Unsafe), flag it to the user as potentially risky before recommending further analysis. See tronscan-token-scanner for full field semantics.
Token List
概述
| 工具 | 功能 | 使用场景 |
|---|
| getTokenList | Token列表 | 按类型筛选,按价格/涨跌幅/成交量/市值/持有者数量排序 |
| getPricedTokenList |
有价格的Token | 所有包含价格数据的Token |
| getTrc20TokenDetail | 单个Token | 列表项完整的TRC20/721/1155详情 |
| getHotSearch | 热门搜索 | 热门Token和合约,包含指标和价格 |
| getSearchBar | 搜索栏 | 热门搜索结果(热门Token列表) |
使用场景
- 1. TRC20 Token列表:使用getTokenList并设置类型筛选为TRC20;使用getPricedTokenList获取有价格的Token。
- 价格与24小时涨跌幅:Token列表和有价格列表包含价格和涨跌幅;使用详情获取完整的24小时数据。
- 24小时成交量:可在列表或详情中获取(如getTrc20TokenDetail),也可在getHotSearch中获取。
- 市值:在Token列表/详情和热门搜索中均可获取。
- 持有者数量:在Token列表/详情中获取。
- 发现优质项目:按成交量、市值或持有者数量排序,结合getHotSearch获取热门项目。
MCP服务器
工具
getTokenList
- - API:getTokenList — 获取Token列表,支持按类型筛选,按价格/涨跌幅/成交量/持有者数量/市值排序
- 使用时机:用户询问Token列表、TRC20列表或按成交量/市值排序的Token时。
- 输入参数:类型、排序字段、排序方式、分页。
- 返回结果:包含关键指标的Token列表。
getPricedTokenList
- - API:getPricedTokenList — 获取所有包含价格数据的Token
- 使用时机:用户询问有价格的Token或有价格的Token列表时。
- 返回结果:包含价格及相关字段的Token。
getTrc20TokenDetail
- - API:getTrc20TokenDetail — 获取TRC20/TRC721/TRC1155 Token详情(名称、符号、供应量、持有者数量、价格等)
- 使用时机:用户需要列表中某个Token的完整指标时(如24小时成交量、持有者数量)。
- 输入参数:合约地址。
getHotSearch
- - API:getHotSearch — 获取热门Token和合约(交易指标和价格数据)
- 使用时机:用户询问热门Token或波场上的热门Token时。
- 返回结果:包含价格和活跃度指标的热门Token/合约。
getSearchBar
- - API:getSearchBar — 获取热门搜索结果(热门Token列表)
- 使用时机:用户询问热门Token或搜索建议时。
故障排除
- - MCP连接失败:如果看到连接被拒绝,请验证TronScan MCP是否已在设置 > 扩展中连接。
- API速率限制/429错误:未使用API密钥时,TronScan API有调用次数和频率限制。如果遇到速率限制或429错误,请前往TronScan开发者API申请API密钥,然后将其添加到MCP配置中并重试。
注意事项
- - 对于优质项目,可将排序(成交量、市值、持有者数量)与热门搜索结合使用,并可选择Token详情进行尽职调查。
- 列表工具支持分页;根据TronScan MCP API使用limit/skip或page/size参数。
- Token列表项可能包含风险字段,如tokenCanShow和tokenLevel。如果列表中的某个Token的tokenCanShow为false或tokenLevel为3(可疑)/4(不安全),请在推荐进一步分析前向用户标记该Token存在潜在风险。完整字段语义请参见tronscan-token-scanner。