核心用法
okx-wallet-portfolio 是 OKX 官方推出的多链钱包资产查询工具，通过本地 CLI 直接与链上数据交互，支持查询任意地址在 XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon 等 50+ 条链的资产情况。
四大核心命令：
onchainos portfolio chains— 获取支持的链列表onchainos portfolio total-value— 查询钱包总资产估值（USD）onchainos portfolio all-balances— 获取全部代币持仓明细onchainos portfolio token-balances— 查询指定代币余额
典型使用场景：
1. 交易前验资：确认地址持有足够代币用于后续 swap
2. 资产总览：快速掌握多链持仓分布与总价值
3. DeFi 仓位：通过 --asset-type 2 单独查询 DeFi 协议持仓
显著优点
- 官方背书：OKX 直接开发与维护，数据来源可信
- 多链聚合：单命令可跨 50 条链批量查询，自动处理 EVM/Solana/UTXO 地址格式差异
- 本地执行：CLI 工具本地运行，私钥不出设备
- 灵活筛选：支持
--exclude-risk 0过滤高风险代币（ETH/BSC/SOL/BASE） - 工作流衔接：与
okx-dex-swap、okx-dex-market等技能形成完整交易闭环
潜在局限与风险
| 局限 | 说明 |
|------|------|
| 非实时数据 | 余额数据依赖 OKX 索引节点，存在分钟级延迟 |
| 包装代币价格偏差 | 带 `x`/`w`/`st` 前缀的封装/质押代币，symbol 和价格元数据可能不准确 |
| 地区限制 | 错误码 50125/80001 表示服务不可用，需切换网络区域 |
| 链格式严格隔离 | EVM 地址与 Solana 地址不能混在同一请求，否则全失败 |
| 依赖外部安装 | 首次使用需下载 `onchainos` 二进制，存在供应链攻击风险（已 mitigated：强制校验 SHA256） |
适合人群
- 需要快速核查第三方地址资产的分析师、审计员
- 进行多链套利或组合管理的专业交易者
- 在交易前自动验资的自动化策略/机器人开发者
- 不适合：想查自己 OKX 登录钱包的用户（应使用
okx-agentic-wallet）
常规风险
1. 地址输入风险：务必核对地址格式，EVM 地址误配 Solana 链将导致查询失败
2. 代币冒充风险：合约地址必须人工核验，同名代币泛滥（输出强制显示缩写地址 0x1234...abcd）
3. 价格误导风险：小额/封装代币价格可能失真，大额持仓建议交叉验证
4. 安装包篡改风险：严格遵循预检流程，任何 SHA256 校验失败必须中止安装
5. API 速率限制：共享密钥可能触发限流，高频场景建议申请个人 API Key