接 OKX DeFi API 做申赎，核心难点不在调通接口，而在理解它返回的不是一笔交易，而是一串按顺序执行的 calldata。/api/v6/defi/transaction/enter 返回的 dataList 里可能先有 APPROVE、再有 DEPOSIT，你必须逐条签名广播，跳步或乱序都会导致链上失败。持仓查询则走另一套接口，/api/v6/defi/user/asset/platform/list 先拿到协议列表和 analysisPlatformId，再用 detail 接口看具体仓位。风险核验的起点是你自己的代码：OKX API 协议明确写了平台只提供"连接和执行"，不提供投资建议，仓位限制和风控措施需要你在应用层自己做。
申购：拿到的是一组 calldata，不是一笔交易
调用 POST /api/v6/defi/transaction/enter 时，必填 investmentId、address 和 userInputList。userInputList 里要传代币合约地址、chainIndex 和 coinAmount（人类可读金额，如 "0.2"，不是 wei）。investmentId 从投资品查询接口获取，不要自己拼。
返回的 dataList 是执行步骤列表。callDataType 区分操作类型（授权、申购、赎回、claim 等），你需要按顺序对每一条签名并广播。以太坊生态的典型情况是先 ERC-20 授权，再执行存款合约调用。如果只签名了 DEPOSIT 而跳过 APPROVE，链上会因 allowance 不足而 revert。广播后拿到的 TxID 要逐条核对，不能只看最后一步成功就认为整个流程完成。
对于 V3 Pool 类型的投资品（如 PancakeSwap V3），新建仓位时还需传 tickLower 和 tickUpper。向已有仓位追加流动性时必须传 tokenId。slippage 参数默认 "0.01"（1%），仅在 adapter/Zap 路由时生效。如果你的场景涉及 DEX Pool，滑点设置直接影响成交结果，默认值是否合适取决于交易对深度。
赎回：共用同一套请求模型，但字段含义变了
赎回同样走 /api/v6/defi/transaction/enter，官方文档说明 enter 和 exit 共用请求模型，部分字段仅在特定操作下有效。实际调用时，investmentId 和 address 仍然是必填，但 userInputList 的含义从"投入的代币"变为"要取回的仓位信息"。对于 V3 Pool 赎回，tokenId 必传。
赎回返回的 dataList 可能包含多步操作，比如先 unstake、再 withdraw、最后 claim 奖励。和申购一样，逐条签名广播，不要假设一步就能完成全部赎回。如果赎回涉及借款还款（Aave 类借贷协议），还需要确认是否有未偿还债务，否则 withdraw 可能因健康度不足而失败。
领取奖励是独立接口 POST /api/v6/defi/transaction/claim，rewardType 区分奖励类型：REWARD_INVESTMENT（投资品矿币奖励，最常用）、REWARD_PLATFORM（协议奖励，需传 analysisPlatformId）、V3_FEE（需传 tokenId）、UNLOCKED_PRINCIPAL（到期本金，需传 principalIndex）。不要把 claim 混在赎回流程里一次做完，分开处理更容易定位问题。
持仓：先查协议列表，再查明细
POST /api/v6/defi/user/asset/platform/list 传入 walletAddressList（每个钱包对应一个链），返回该地址在各 DeFi 协议中的持仓概况：协议名称、总资产 USD、投资品数量、analysisPlatformId。响应里的 assetStatus 字段值得注意：1 表示已更新，2 表示更新中。如果是 2，当前返回的数据可能不是最新状态，需要等待或重新查询。
拿到 analysisPlatformId 后调 detail 接口看具体仓位。明细里会区分 assetsTokenList（资产代币）、borrowTokenList（借款代币，LSDFI 场景）、rewardDefiTokenInfo（复利奖励）、unclaimedFeesDefiTokenInfo（Uni V3 手续费）等。totalValue 是 USD 计价，依赖价格源，不要把它当作精确的链上余额来用。跨协议、跨链聚合持仓时，不同协议的 updateAt 时间戳可能不一致，汇总数字需要理解这一点。
风险核验：平台不替你做的部分
OKX API 协议的表述很直接：平台只提供连接数据和执行订单的服务，不提供投资建议、交易推荐或投资组合管理。这意味着以下判断必须在你自己的应用层完成：
投资品本身的合约风险。API 聚合了数十个 DeFi 协议，但每个协议的智能合约安全性、审计状态、历史事件都不在 API 返回字段里。investmentId 能帮你定位产品，但不能告诉你这个池子是否可信任。
借款场景的健康度监控。如果你用 enter 接口执行借款操作（如 Aave V3 Borrow），API 不会主动推送健康度预警。你需要自己轮询持仓明细中的 healthRate 字段（LSDFI 场景下返回），或在应用层设定阈值触发提醒/自动还款。
滑点和路由风险。slippage 默认 1% 是通用值，不是对你所交易资产的最优值。低流动性池子里 1% 可能不够，高波动时又可能过宽导致被 MEV 套利。这个参数需要根据实际交易对调整，API 不会替你判断。
一个可执行的核验动作：在广播任何 dataList 中的交易之前，先用 eth_call 或链上模拟工具跑一遍，确认不会 revert。这能拦住授权不足、余额不够、健康度不足、滑点超限这类问题，避免付了 gas 才失败。签名广播后，TxID 的链上状态（success/reverted）才是最终验收标准，API 返回的 dataList 只是待执行指令，不是执行结果。
参考资料
- OKX Wallet·申购（DeFi API 交易执行），核查日期：2026-10-22
- OKX Wallet·用户持仓概览（DeFi API），核查日期：2026-10-22
- OKX Wallet·Holdings Detail（DeFi API），核查日期：2026-10-22
- OKX·OKX API Agreement（责任与限制条款），核查日期：2026-10-22
- OKX Wallet·领取 DeFi 协议奖励（DeFi API），核查日期：2026-10-22
- OKX Wallet·DeFi API 介绍，核查日期：2026-10-22
- OKX Wallet·投资品查询（DeFi API），核查日期：2026-10-22
