查询用户协议维度持仓列表

在DeFi生态中，用户通常需要跨多个协议管理自己的资产持仓。通过协议维度持仓查询功能，开发者可以高效获取用户在特定DeFi协议中的资产分布情况，为投资分析、风险管理等场景提供数据支持。

接口概述

本接口用于查询用户在指定DeFi协议中的资产持仓列表，支持多地址批量查询，返回结果包含详细的资产类型、数量和价值信息。

核心功能

协议维度查询：按特定DeFi协议获取用户持仓数据
多地址支持：同时查询多个钱包地址在同一协议中的资产
跨链兼容：支持不同公链上的协议持仓查询
价值评估：提供美元计价的价值评估，便于资产汇总

请求详情

请求地址

POST https://web3.okx.com/api/v5/defi/user/asset/platform/detail

请求参数

参数名称	描述	参数类型	必传	数据类型
analysisPlatformId	协议唯一标识符	请求体	是	String
walletAddressList	钱包地址列表	请求体	是	Array
>chainId	公链标识	请求体	是	String
>walletAddress	用户钱包地址	请求体	是	String

参数说明

analysisPlatformId：需要查询的DeFi协议ID，每个协议都有唯一的标识符

walletAddressList：支持传入多个钱包地址进行批量查询，每个地址需要指定对应的公链链ID

响应参数详解

接口返回详细的持仓信息，包括资产类型、数量、价值等关键数据。

网络层级信息

networkHoldVoList：网络维度持仓列表
- network：网络名称（如Ethereum、BNB Chain等）
- chainId：链ID标识
- investTokenBalanceVoList：投资资产详情列表

资产详情信息

每个投资资产包含以下详细信息：

investType：投资类型
- 1：存币
- 2：流动性池
- 3：挖矿
- 4：机枪池
- 5：质押
tokenSymbol：资产符号（如ETH、USDT等）
tokenLogo：资产图标URL
coinAmount：资产数量
currencyAmount：美元计价价值
tokenPrecision：代币精度（小数位数）
tokenAddress：代币合约地址
**network`：所属网络

协议信息

platformName：协议名称
analysisPlatformId：协议ID
platformLogo：协议图标
**platformUrl`：协议官方网站链接

应用场景

投资组合管理

通过此接口，用户可以聚合在不同DeFi协议中的资产，全面了解自己的投资分布情况，👉查看实时资产分析工具来优化投资策略。

风险监控

实时监控在不同协议中的资产价值变化，及时发现异常情况并采取相应措施。

税务申报

获取准确的资产价值数据，为税务申报和财务规划提供依据。

协议对比分析

比较用户在不同DeFi协议中的资产配置，评估各协议的表现和收益情况。

开发注意事项

地址格式验证：确保传入的钱包地址格式正确且与指定链ID匹配
错误处理：合理处理网络异常、参数错误等异常情况
数据缓存：适当缓存查询结果，避免频繁调用接口
权限控制：确保只有授权用户才能查询相关地址的持仓信息

性能优化建议

批量查询多个地址时，建议合理控制每次请求的地址数量
对于实时性要求不高的场景，可以使用缓存减少接口调用频率
关注接口响应时间，必要时进行异步处理

常见问题

什么是协议维度持仓查询？

协议维度持仓查询是指按DeFi协议来聚合用户的资产持仓情况，不同于按钱包地址或按资产的查询方式，这种方式更便于分析用户在特定协议中的投资情况。

支持哪些类型的DeFi协议？

目前支持主流DeFi协议，包括去中心化交易所、借贷协议、收益农场、质押协议等，具体可通过协议列表接口获取支持的协议信息。

如何获取协议ID？

协议ID可以通过协议列表查询接口获取，每个DeFi协议都有唯一的analysisPlatformId用于标识。

查询结果中的价值是如何计算的？

资产价值基于实时市场价格计算，以美元为计价单位，数据来自多家权威价格预言机。

是否支持历史持仓查询？

当前接口仅提供最新持仓数据，历史数据需要通过专门的历史查询接口获取。

最大支持多少地址批量查询？

单次请求最多支持50个钱包地址的批量查询，超过限制需要分多次请求。

总结

协议维度持仓查询API为开发者提供了强大的DeFi资产查询能力，通过这个接口可以方便地获取用户在特定协议中的详细持仓信息。无论是构建投资分析工具、风险管理平台还是财务监控系统，这个接口都能提供可靠的数据支持。