查询认购的预估计算信息#
描述: 该 API 将给你指定投资品的预估认购收益详情。内容包括：
- 超级节点名、预估网络费相关；
- 接收代币列表、凭证代币详情列表、收益代币详情列表、代币授权状态列表（包括是否需要授权）；
- 可申购金额、最小申购数额、最大申购数额、币种交换汇率等。
请求地址#
POST https://web3.okx.com/api/v5/defi/calculator/subscribe-info
请求参数#
| 参数名称 | 相关描述 | 数据类型 | 必传 | 数据类型 |
|---|---|---|---|---|
| address | 用户钱包地址 | 请求体 | 否 | String |
| inputAmount | 认购代币数量 | 请求体 | 是 | String |
| investmentCategory | 认购类型：(0：默认类型；1：BRC-20) | 请求体 | 否 | String |
| investmentId | 投资品 ID (这里获取) | 请求体 | 是 | String |
| inputTokenAddress | 认购代币的智能合约地址 (这里获取) | 请求体 | 是 | String |
| isSingle | 判断是否为单币投资品：是：单币；否：多币 | 请求体 | 否 | Boolean |
| slippage | 滑点：默认为 1% | 请求体 | 否 | String |
响应参数#
| 参数名称 | 相关描述 | 数据类型 |
|---|---|---|
| validatorName | 超级节点名称 | String |
| isAllowSubscribe | 是否允许申购 | Boolean |
| estimateGasFee | 收益率计算类型：0：APY；1：APR | String |
| isSwapInvest | 是否是兑换投资 | Boolean |
| exchangeRate | 币种汇率 | String |
| investWithTokenList | 质押代币 | Array[Struct] |
| >coinAmount | 币种数量 | String |
| >currencyAmount | 币种美元价值 | String |
| >tokenSymbol | 币种标识 | String |
| >tokenName | 币种名称 | String |
| >tokenAddress | 币种的智能合约地址 | String |
| >tokenPrecision | 币种精确小数位 | String |
| >isBaseToken | 质押代币是否为主网基准代币 | Boolean |
| >network | 币种网络 | String |
| >chainId | 币种的链 ID | String |
| >dataType | 0：利息收益；1：矿币收益；2：手续费；3：奖励金 | String |
| gainsTokenList | 收益代币列表：结构同 investWithTokenList | Array[Struct] |
| receiveTokenInfo | 投资收到的凭证代币：结构同 investWithTokenList | Array[Struct] |
| approveStatusList | 币种授权状态列表 | Array[Struct] |
| >tokenSymbol | 币种标识 | String |
| >tokenAddress | 币种的智能合约地址 | String |
| >tokenPrecision | 币种精确小数位 | String |
| >isNeedApprove | 是否需要授权 | Boolean |
| >approveAddress | 需要授权的合约地址 | String |
| >network | 币种网络 | String |
| >chainId | 币种的链 ID | String |
| >orderType | 类型透传给 Call data 的参数 (3：买入授权；4：赎回授权；8：进入 Farm；9：离开 Farm) | String |
请求示例#
shell
curl --location 'https://web3.okx.com/api/v5/defi/calculator/subscribe-info' \
--header 'OK-ACCESS-KEY: 9c****77' \
--header 'OK-ACCESS-PASSPHRASE: p****d' \
--header 'Content-Type: application/json' \
--data '{
"inputAmount": "1",
"inputTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"isSingle": false,
"tokenDecimal": "18",
"investmentId": "21915",
"address": "0x7f****da",
"investmentType": 0
}'
响应示例#
200
{
"code": 0,
"msg": "",
"data": {
"investWithTokenList": [
{
"tokenSymbol": "CORE",
"tokenName": "Core",
"tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"network": "CORE",
"chainId": "1116",
"tokenPrecision": "18",
"isBaseToken": true,
"coinAmount": "1",
"currencyAmount": "0.5035"
}
],
"gainsTokenList": [
{
"tokenSymbol": "CORE",
"tokenName": "Core",
"tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"network": "CORE",
"tokenPrecision": "18",
"coinAmount": "0.000742226856350101",
"dataType": "0"
}
],
"approveStatusList": [
{
"tokenSymbol": "CORE",
"tokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"network": "CORE",
"chainId": "1116",
"tokenPrecision": "18",
"isNeedApprove": false,
"approveAddress": "0x0000000000000000000000000000000000001007",
"orderType": "3"
}
],
"isSwapInvest": false,
"estimateGasFee": "99343",
"isAllowSubscribe": true,
"validatorName": "OKXEarn"
}
}