Menu
Use when: token search, token info, token price, token metadata, find token address, search by symbol, get decimals. 中文: 代币搜索, 代币信息, 代币价格, 查代币, 搜索代币, 代币地址.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Use when: register bridge adapter, add bridge protocol, 注册bridge, 新增bridge协议, wire up new bridge, plug in new cross-chain adapter, install bridge adapter. NOT for bridge execution flow (use web3-bridge). NOT for swap adapters.
Use when: register security check, add security rule, 注册security check, 新增安全检测规则, wire up new static check, install security rule. NOT for changing existing check logic — only for adding a new rule struct.
Use when: register swap adapter, add swap protocol, 注册swap, 新增swap协议, wire up new DEX, plug in new aggregator, install swap adapter. NOT for swap execution flow (use web3-swap). NOT for bridge adapters.
Use when: bridge tokens, cross-chain swap, move assets between chains, cross-chain transfer, bridge quote. NOT for same-chain swaps. 中文: 跨链, 桥接, 跨链桥, 跨链转账, 资产跨链（仅限跨链，不含同链兑换）.
Use when: gas price, gas estimate, broadcast transaction, check tx status, transaction hash, chain info, gas cost, tx confirmed, transfer ETH, send tokens, transfer USDC, transfer USDT, send crypto, token transfer. 中文: gas费, gas估算, 广播交易, 查交易状态, 交易哈希, 链上确认, 转账, 发送代币, 转ETH, 转USDC, 转账代币.
Use when: check balance, wallet holdings, portfolio value, what tokens do I have, show my assets, account overview, total value. 中文: 余额, 持仓, 投资组合, 资产, 账户余额, 钱包余额.
Based on SOC occupation classification
| name | web3-token |
| description | Use when: token search, token info, token price, token metadata, find token address, search by symbol, get decimals. 中文: 代币搜索, 代币信息, 代币价格, 查代币, 搜索代币, 代币地址. |
| license | MIT |
| metadata | {"author":"blocksecteam","version":"1.0.0"} |
Tag semantics (<NEVER> / <MUST> / <SHOULD>): see ~/.claude/skills/_shared/tags.md.
Supported chains are determined by the deployment configuration — run web3 chain list for the current set. Do not hardcode chain names in this skill.
Token search, metadata, and price across blockchains. Used to resolve symbols to addresses before swaps.
web3-swap.web3-bridge.web3-chain.web3-portfolio.web3-security.web3-ssm.All parameters below must be explicitly stated by the user. Do NOT infer, assume, or default any of them — ask the user first if not clearly specified.
| Parameter | Rule |
|---|---|
--chain | Must be confirmed by the user; the CLI has no default. Token addresses, decimals, and prices differ per chain. |
--query / token address | Must be confirmed. The specific token or search term the user wants. |
web3 token search --query USDC --chain ethereum
token search searches by symbol/name text. It does not support native tokens (ETH/BNB/POL have no contract address to search). For native token price or info, use web3 token info --chain <chain> native.
Search results for "
<query>":
<symbol>—<chain>—<address_short>— $<price><symbol>—<chain>—<address_short>— $<price><symbol>—<chain>—<address_short>— $<price>Which one would you like details on?
Multiple results → let user pick. Single result → show details and confirm. Never assume the first result is the one the user wants.
"No tokens found matching 'X'. Try a different search term or provide the contract address directly."
For ERC-20 tokens:
web3 token info --chain ethereum 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
For native tokens:
web3 token info --chain ethereum native
<symbol>—<name>
Detail Value Chain <chain>Address <address_short>Decimals <decimals>Price $ <price>Market Cap $ <market_cap>Liquidity $ <liquidity>
Then suggest next steps: "Would you like to check your balance, see a price chart, or swap this token?"
$1.2B, $45M)0x1234...abcd(native) tag instead of address| Scenario | Handling |
|---|---|
| Token not found | "Token not found. Try verifying the address — symbols can collide across chains." |
| Same symbol, multiple chains | Show ALL matches, let user pick |
| Network error | Retry once |
If the command returns an error.code (e.g. portals_error when the Portals upstream is down, unsupported_chain for an invalid --chain), consult ~/.claude/skills/_shared/error-codes.md.