核心用法
OKX Wallet Portfolio 是一款面向多链资产管理场景的 CLI 工具，由 OKX 官方开发维护，支持通过命令行快速查询钱包资产。核心功能覆盖四大场景：
1. 链支持查询：onchainos portfolio chains 获取当前支持的 20+ 条公链列表
2. 总资产估值：total-value 命令聚合多链资产，输出美元计价总额
3. 全量持仓明细：all-balances 返回代币名称、数量、单价、USD 价值的完整列表
4. 指定代币查询：token-balances 针对特定合约地址精确查询余额
命令设计遵循人性化交互原则，支持链名称（如 xlayer）与链 ID（如 196）自动解析，无需用户记忆复杂数字。地址格式自动识别 EVM（0x...）、Solana（Base58）、Bitcoin 等不同标准，避免跨链混用导致的查询失败。
显著优点
- 官方背书：OKX 交易所直接开发，API 数据源与交易所级资产系统同源，价格与余额数据权威性高
- 多链聚合：原生支持 XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon 等主流公链，单命令最多可聚合 50 条链数据
- 风险过滤：
--exclude-risk参数可自动屏蔽高风险代币，降低用户接触诈骗币、土狗币的概率 - DeFi 兼容：支持查询 DeFi 协议持仓（
--asset-type 2），覆盖 LP、质押等复杂头寸 - 工作流衔接：与 OKX DEX 生态深度整合，余额查询结果可直接输入 Swap 模块，形成「查余额 → 验充足 → 下交易」的闭环
潜在缺点与局限性
- 地域限制：部分国家/地区用户可能遭遇服务不可用（错误码 50125/80001），需切换网络环境
- 风控局限：
--exclude-risk仅对 ETH/BSC/SOL/BASE 四条链生效，其他链的诈骗代币仍需人工甄别 - 离线依赖：必须联网调用 OKX 节点，无法本地离线签名查询
- 隐私考量：查询需向 OKX 服务端提交钱包地址，存在地址关联分析的理论风险
- 学习成本：纯 CLI 界面，对非技术用户不够友好，需配合终端环境使用
适合人群
- 多链 DeFi 活跃用户，需频繁跨链追踪资产分布
- 交易员与量化团队，需自动化获取持仓数据以驱动策略
- 开发者与 CLI 重度用户，偏好命令行效率而非图形界面
- 需要执行 Swap 前快速验资的场景用户
常规风险
1. 钓鱼脚本风险：安装命令通过 curl | sh 执行，若仓库被篡改则存在供应链攻击可能。建议核对官方 GitHub 仓库签名后再执行
2. API 凭据泄露：可选的 .env 配置若未妥善保管，可能导致 OKX API 密钥泄露
3. 地址输入错误：EVM 与 Solana 地址格式差异大，混用会导致查询结果为空但不会报错，易误判为零余额
4. 价格波动风险：显示的 USD 价值为实时市价，极端行情下与实际可成交价格存在显著偏差
5. 区域合规风险：服务可用性受当地监管政策影响，用户需自行确认合规性