查询 DeFi 持仓
查询一个或多个钱包地址在 BSC 上的 DeFi 持仓。返回协议级持仓汇总及代币明细。可通过 binanceChainIds 过滤特定链。
持仓覆盖范围比数据查询与交易构建所用的协议清单更宽——差异见支持的链与协议。
查询 DeFi 持仓 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名（Base64 编码）。
X-OC-RECV-WINDOW允许的时间偏差（毫秒），默认值 5000，最大值 60000。
X-OC-NONCE唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。
查询 DeFi 持仓 › 请求体
addresses要查询持仓的钱包地址列表，单次最多 3 个（服务端配置，可能调整）。
binanceChainIds可选的链过滤。指定时仅返回对应链上的持仓。本期仅支持 BSC（"56"）。
查询 DeFi 持仓 › 响应
成功返回 DeFi 持仓。
code业务状态码，0 表示成功。
msg状态说明。
聚合的 DeFi 持仓响应。
totalValue所有查询地址的 DeFi 持仓总价值（美元）。与 addressTotalValue 同原始精度。
地址级持仓汇总列表。
address钱包地址。
addressTotalValue该地址所有链上 DeFi 持仓总价值（美元）。与持仓明细同原始精度。
该地址的协议级持仓汇总列表。
timestamp服务端时间戳（毫秒）。
success请求是否成功（等价于 code == 0）。
获取 DeFi 协议列表
获取支持的 DeFi 协议列表，可按链和投资类型过滤。支持分页和排序。
获取 DeFi 协议列表 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名（Base64 编码）。
X-OC-RECV-WINDOW允许的时间偏差（毫秒），默认值 5000，最大值 60000。
X-OC-NONCE唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。
获取 DeFi 协议列表 › 请求体
binanceChainId按 Binance 链 ID 过滤（如 "56"=BSC）。
investType按投资类型过滤。已知取值：Earn、LiquidityPool。
sortField排序字段。仅接受两个取值：tvl、apy。注意：按收益率排序传 apy （服务端字段名），虽然响应返回的是 apyBps / apyDisplay。不支持其他取值。
sortDirection排序方向。
page页码（从 1 开始）。
size每页条数，最大 200。
获取 DeFi 协议列表 › 响应
成功返回协议列表。
code业务状态码，0 表示成功。
msg状态说明。
分页的协议列表结果。
page当前页码（从 1 开始）。
size每页条数。
total总记录数。
当前页的协议列表。
defiProtocolIdDeFi 协议标识。
protocolName协议显示名称。
protocolLogo协议 Logo 图片 URL（完整 URL，直接使用）。
tvl协议锁仓总价值（美元）。字符串，保留数据源原始精度。
apyBps该协议下最高 APY，以基点表示（1 bps = 0.01%）。整数值——用于排序 / 比较 / 筛选，不要使用裸小数。
apyDisplay预格式化的 APY 展示字符串（如 "12.35%"）。直接原样引用，禁止二次计算或转换。
investType该协议支持的投资类型——此处为数组（一个协议可支持多种）。注意：投资品维度的 investType（投资品列表 / 详情中）是单个字符串。已知取值：Earn、LiquidityPool。
supportedChains支持的 Binance 链 ID 列表。
timestamp服务端时间戳（毫秒）。
success请求是否成功（等价于 code == 0）。
获取协议详情
获取指定 DeFi 协议的详细信息，包括描述、亮点、CertiK 安全评分、团队、融资、社交媒体和 FAQ。
获取协议详情 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名（Base64 编码）。
X-OC-RECV-WINDOW允许的时间偏差（毫秒），默认值 5000，最大值 60000。
X-OC-NONCE唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。
获取协议详情 › 响应
成功返回协议详情。
code业务状态码，0 表示成功。
msg状态说明。
DeFi 协议详情。
defiProtocolIdDeFi 协议标识。
protocolName协议显示名称。
protocolLogo协议 Logo 图片 URL（https://bin.bnbstatic.com 下的完整 URL）。
description协议描述（已翻译，直接展示）。
websiteUrl官网 URL。
investType该协议支持的投资类型——此处为数组（一个协议可支持多种）。注意：投资品维度的 investType（投资品列表 / 详情中）是单个字符串。已知取值：Earn、LiquidityPool。
supportedChains支持的 Binance 链 ID 列表。
tvl锁仓总价值（美元）。字符串，保留数据源原始精度。
tags协议标签 / 分类。
founded成立年份（YYYY）。
fdv完全稀释估值（FDV）。
totalFunding累计融资金额。未披露时为 null。
协议社交媒体链接。
xX（Twitter）主页 URL。无时为 null。
discordDiscord 邀请链接。无时为 null。
githubGitHub 组织 URL。无时为 null。
linkedinLinkedIn 公司主页 URL。无时为 null。
telegramTelegram 频道 URL。无时为 null。
gitbookGitBook 文档 URL。无时为空字符串或 null。
website官网 URL。
团队成员列表。
name成员姓名。
role成员角色 / 职位。
twitter成员 X（Twitter）主页 URL。无时为 null。
linkedin成员 LinkedIn 主页 URL。无时为 null。
bio成员简介。无时为 null。
融资历史。
round轮次名称（如 Strategic）。
amount融资金额。未披露时为 null。
date轮次日期。
investors投资方列表。
securityScoreCertiK 综合安全评分。
CertiK 六维度安全评分。
codeSecurity代码安全评分。
fundamentalHealth基本面健康度评分。
operationalResilience运营韧性评分。
communityTrust社区信任评分。
governanceStrength治理强度评分。
marketStability市场稳定性评分。
highlights协议亮点（已翻译，直接展示）。
FAQ 条目列表（问答文本，已翻译）。
titleFAQ 问题文本（已翻译，直接展示）。
answerFAQ 答案文本（已翻译，直接引用）。可能包含换行标记 <Br/> 和段落间距标记 <Gap/>， 解析时按换行 / 段落处理。
timestamp服务端时间戳（毫秒）。
success请求是否成功（等价于 code == 0）。
获取 DeFi 投资品列表
获取可用的 DeFi 投资品列表。可按协议、链、投资类型或合约地址过滤。支持分页和排序。
获取 DeFi 投资品列表 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名（Base64 编码）。
X-OC-RECV-WINDOW允许的时间偏差（毫秒），默认值 5000，最大值 60000。
X-OC-NONCE唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。
获取 DeFi 投资品列表 › 请求体
investType按投资类型过滤，必填。已知取值：Earn、LiquidityPool。
defiProtocolId按 DeFi 协议 ID 过滤。
tokenAddressList按代币地址过滤。
binanceChainId按 Binance 链 ID 过滤（如 "56"=BSC）。
sortField排序字段。仅接受两个取值：tvl、apy。注意：按收益率排序传 apy （服务端字段名），虽然响应返回的是 apyBps / apyDisplay。不支持其他取值。
sortDirection排序方向。
page页码（从 1 开始）。
size每页条数，最大 100。
获取 DeFi 投资品列表 › 响应
成功返回投资品列表。
code业务状态码，0 表示成功。
msg状态说明。
分页的投资品列表结果。
page当前页码（从 1 开始）。
size每页条数。
total总记录数。
当前页的投资品列表。
binanceChainIdBinance 链 ID。
defiProtocolId所属 DeFi 协议标识。
protocolName协议显示名称。
investmentId投资品标识（64 位 hex，无 0x 前缀）。与 POST /api/v1/defi/data/position/list 返回的 investmentIds、交易构建接口接收的格式一致。
investmentName投资品显示名称。
investType该投资品的投资类型——此处为单个字符串（每个投资品只有一种）。注意：协议维度的 investType（协议列表 / 详情中）是数组。已知取值：Earn、LiquidityPool。
apyType收益率类型。已知取值：APY、APR。
apyBps年化收益率，以基点表示（1 bps = 0.01%）。整数值——用于排序 / 比较 / 筛选，不要使用裸小数。
apyDisplay预格式化的 APY 展示字符串（如 "1,562.65%"）。直接原样引用，禁止二次计算或转换。
tvl该投资品锁仓总价值（美元）。字符串，保留数据源原始精度。
timestamp服务端时间戳（毫秒）。
success请求是否成功（等价于 code == 0）。
获取投资品详情
获取指定 DeFi 投资品的详细信息，包括 APY、TVL、支持的代币（投入 / 奖励 / LP / 借入）、池地址、费率和可投状态。
获取投资品详情 › 授权
请求头
X-OC-APIKEYBinance Web3 API 颁发的用于鉴权的 API Key。
X-OC-TIMESTAMP当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。
X-OC-SIGN请求签名（Base64 编码）。
X-OC-RECV-WINDOW允许的时间偏差（毫秒），默认值 5000，最大值 60000。
X-OC-NONCE唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。
获取投资品详情 › 请求体
investmentId投资品标识（64 位 hex，无 0x 前缀）。与 POST /api/v1/defi/data/position/list 返回的 investmentIds 格式一致。
获取投资品详情 › 响应
成功返回投资品详情。
code业务状态码，0 表示成功。
msg状态说明。
DeFi 投资品详情。
binanceChainIdBinance 链 ID。
defiProtocolId所属 DeFi 协议标识。
protocolName协议显示名称。
protocolLogo协议 Logo 图片 URL（完整 URL，直接使用）。
investmentId投资品标识（64 位 hex，无 0x 前缀）。与 POST /api/v1/defi/data/position/list 返回的 investmentIds、交易构建接口接收的格式一致。
investmentName投资品显示名称。
investType该投资品的投资类型——此处为单个字符串（每个投资品只有一种）。注意：协议维度的 investType（协议列表 / 详情中）是数组。已知取值：Earn、LiquidityPool。
investable该投资品当前是否可投。
apyBps年化收益率，以基点表示（1 bps = 0.01%）。整数值——用于排序 / 比较 / 筛选，不要使用裸小数。
apyDisplay预格式化的 APY 展示字符串（如 "1,562.65%"）。直接原样引用，禁止二次计算或转换。
apyType收益率类型。已知取值：APY、APR。
tvl锁仓总价值（美元）。字符串，保留数据源原始精度。
poolAddress池 / 策略合约地址。
feeRate费率字符串（如 "0.001" = 0.1%）。
需投入的代币列表。
tokenAddress代币合约地址。主链币使用 sentinel 地址。
tokenName代币名称。
tokenSymbol代币符号。
奖励代币列表。
tokenAddress代币合约地址。主链币使用 sentinel 地址。
tokenName代币名称。
tokenSymbol代币符号。
LP 代币列表（流动性仓位）。
tokenAddress代币合约地址。主链币使用 sentinel 地址。
tokenName代币名称。
tokenSymbol代币符号。
借入代币列表（借贷借入仓位）。
tokenAddress代币合约地址。主链币使用 sentinel 地址。
tokenName代币名称。
tokenSymbol代币符号。
timestamp服务端时间戳（毫秒）。
success请求是否成功（等价于 code == 0）。