用途:根据用户提供的公开钱包地址,跨链查询资产组合,包括钱包总价值、全部代币余额和指定代币余额。支持 XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon 等 20 多条链。
主要能力(4 个命令):
- onchainos portfolio chains:查询支持余额查询的链。
- onchainos portfolio total-value --address <address> --chains <chains>:查询钱包总资产价值(两个参数必填)。
- onchainos portfolio all-balances --address <address> --chains <chains>:查询全部代币余额(两个参数必填)。
- onchainos portfolio token-balances --address ... --tokens ...:查询指定代币余额。
使用方式:先识别意图,再收集参数。缺少钱包地址时向用户询问;缺少目标链时建议默认 XLayer(--chains xlayer,低 gas、确认快),常用组合为 "xlayer,solana,ethereum,base,bsc"。需要过滤风险代币可设 --exclude-risk 0(仅 ETH/BSC/SOL/BASE 有效)。--chains 最多 50 条链,超出需分批;token-balances 最多 20 个代币。--asset-type:0=全部,1=仅代币,2=仅 DeFi(仅用于 total-value)。CLI 自动解析链名(如 ethereum→1,solana→501),并通过环境变量处理认证。
展示规则:金额用 UI 单位(如 1.5 ETH),USD 保留两位小数,大额用简写($1.2M),按 USD 价值降序排列,并始终显示代币符号与缩写合约地址(如 0x1234...abcd,原生代币显示 native)。
限制与注意:EVM 地址(0x…)与 Solana(Base58)、Bitcoin(UTXO)地址格式不兼容,混用会导致整个请求失败且无部分结果,需分别请求。零余额是有效状态,显示 $0.00。包装/跨链代币的符号与价格元数据可能不准,需核对合约地址。区域限制错误(50125 或 80001)应提示服务在当前区域不可用。网络错误重试一次后提示稍后再试。PnL、胜率、DEX 交易历史、代币价格/K 线、代币搜索、聪明钱信号、meme 扫描、兑换执行、交易广播等应使用其他对应技能。详细参数表与返回字段见 references/cli-reference.md。