核心用法
okx-wallet-portfolio 是 OKX 官方提供的链上资产查询技能，通过 CLI 工具 onchainos 实现跨链钱包画像分析。核心功能覆盖四大场景：
1. 全链资产总览：portfolio total-value 计算多链钱包的 USD 总价值（支持 XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon 等 20+ 链）
2. 代币持仓明细：portfolio all-balances 返回按 USD 价值排序的完整持仓列表，包含代币符号、UI 单位余额、估值及缩写合约地址
3. 特定代币查询：portfolio token-balances 支持最多 20 个指定代币的精准余额检索
4. DeFi 头寸追踪：通过 --asset-type 2 参数单独查询 DeFi 协议持仓
关键特性包括：
- 链名自动解析：支持
ethereum→1、solana→501等人性化输入 - 风险过滤：
--exclude-risk 0可筛除高风险代币（仅 ETH/BSC/SOL/BASE 支持） - 批量查询优化：单次最多 50 条链，超限自动分批处理
显著优点
| 维度 | 优势 |
|------|------|
| **数据权威性** | 直接对接 OKX 官方节点与价格 feed，非第三方聚合器，减少预言机操纵风险 |
| **跨链覆盖** | 原生支持 OKX 自研的 XLayer（chainIndex 196），同时兼容 EVM 全生态与 Solana UTXO 体系 |
| **工程严谨性** | 内置二进制完整性校验（SHA256 验证）、自动版本漂移检测、离线降级策略 |
| **安全设计** | 明确区分「用户主动提供地址」与「登录态钱包」场景，杜绝会话劫持风险 |
| **工作流衔接** | 与 OKX DEX 系列技能（swap、market、signal）形成完整闭环，支持 Pre-Swap 余额校验 → 报价 → 执行的数据流转 |
潜在缺点与局限性
- 非自主托管数据：依赖 OKX 中心化 API，存在单点故障与区域性服务限制（错误码 50125/80001 触发地区屏蔽）
- 包装代币价格失真：对
x/w/st/r/m前缀的封装/质押代币，符号与价格元数据可能不准确，需人工交叉验证 - 地址格式严格隔离：EVM 地址（
0x...）与 Solana Base58 地址不能混用，错误搭配导致整批请求失败而非部分返回 - CLI 环境依赖：需本地安装
onchainos二进制，Windows/macOS/Linux 需分别处理安装脚本，对非技术用户门槛较高 - 速率限制：共享 API Key 可能触发限流，需引导用户至 OKX Developer Portal 创建个人密钥
适合人群
- DeFi 交易者：需要跨链仓位聚合视图，执行 Pre-Swap 余额校验
- 资产审计需求方：定期核查多链钱包持仓，追踪 DeFi 挖矿头寸
- 量化分析师：通过 CLI 输出做自动化数据处理，结合
okx-dex-market做 PnL 归因 - 非技术用户需谨慎：虽支持人性化链名，但 CLI 安装、环境变量配置、SHA256 校验等步骤对普通用户仍有摩擦
常规风险
| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|
| **数据可信度风险** | 包装/桥接代币价格元数据可能错误标记 | 始终显示缩写合约地址，提示用户交叉验证 |
| **地址误配风险** | EVM 与 Solana 地址混用导致查询失败 | 技能内置格式校验，强制分链请求 |
| **供应链攻击** | 安装脚本或二进制被篡改 | 强制 SHA256 校验，校验失败即阻断执行 |
| **区域合规风险** | 部分地区 API 服务受限 | 友好提示切换地区，不暴露原始错误码 |
| **会话混淆风险** | 用户说「查我的余额」却未提供地址时，技能明确拒绝并路由至 `okx-agentic-wallet` | 严格的意图识别与技能路由规则 |