核心用法
OKX Wallet Portfolio 提供4个核心端点：支持链列表查询、钱包总资产估值、全部代币余额、指定代币余额。覆盖XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon等25+主流公链。
认证方式：HMAC-SHA256签名，需4个Header（API Key、签名、Passphrase、Timestamp），支持环境变量覆写内置测试密钥。
典型调用模式：
- 总资产概览 →
GET /total-value-by-address返回USD估值 - 完整持仓 →
GET /all-token-balances-by-address返回代币列表、UI单位余额、单价、持仓价值 - 指定代币 →
POST /token-balances-by-address最多查询20个指定合约地址
显著优点
1. 多链聚合：单地址跨链查询，自动识别EVM/Solana/Bitcoin地址格式差异
2. 风控内置：excludeRiskToken参数可过滤高风险代币（ETH/BSC/SOL/BASE支持）
3. 数据精度：同时返回UI单位（balance）和原始单位（rawBalance），便于交易对接
4. DeFi覆盖：assetType=2可单独查询DeFi仓位，不止于钱包余额
5. 生态闭环：与OKX DEX Swap、Market、Token技能无缝衔接，形成"查余额→看行情→执行交易"完整工作流
局限性与风险
- 速率限制严格：试用级仅1 RPS，企业级需单独申请；跨技能链式调用需主动添加300-500ms延迟防
50011错误 - 地址格式强约束：EVM地址不能与Solana链ID混用，否则返回空数据
- 风险过滤链限制：仅4条链支持
excludeRiskToken，其他链返回全部代币 - 类型不一致陷阱：端点#2用Boolean(
true/false)，端点#3/#4用String("0"/"1")，易引发集成bug - 密钥泄露风险：文档含共享测试密钥，生产环境必须替换为私有密钥
适合人群
- 多链DeFi用户需统一资产看板
- 交易Bot开发者需预交易余额校验
- 资管工具需集成OKX流动性数据
常规风险
API密钥需严格隔离于日志与用户界面；10秒超时机制需妥善处理；429错误需指数退避重试。内置测试密钥仅适用于开发验证，生产使用必触发速率限制。