查询产品列表#

描述：当你输入搜索条件后，该 API 将提供指定条件的可分页投资品列表。

请求地址#

POST https://www.okx.com/api/v5/defi/explore/product/list

请求参数#

参数名称	相关描述	参数类型	必传	数据类型
simplifyInvestType	查询投资品类型 (100：稳定币；101：单币赚币；102；多币赚币；103：机枪池)	请求体	是	String
network	查询网络名称 (从这里获取)	请求体	是	String
poolVersion	区别 V2 和 V3 类型流动池，默认为 V2	请求体	否	String
platformIds	平台 ID (从这里获取)	请求体	否	Array[String]
sort	分类查询	请求体	否	Struct
>orders	按订单分类查询	请求体	否	Array[Struct]
>>direction	排序方向：(升序 - ASC、降序 - DESC)	请求体	否	String
>>property	结果排序的属性名 (可排序字段：锁仓量 - TVL、APY利率 - RATE)	请求体	否	String
tokenIds	查询币种 ID 列表 (从这里获取)	请求体	否	Array[String]
offset	可分页的偏移量	请求体	否	String
limit	可分页限制	请求体	是	String

响应参数#

参数名称	相关描述	数据类型
investmentId	投资品 ID	String
investmentName	投资品名称	String
chainId	区块链 ID	String
rate	收益率	String
investType	投资品类型：1. 存币；2. 流动性池；3. 挖矿；4. 机枪池；5. 质押	String
platformName	平台名称	String
platformId	平台 ID	String
rateType	收益率计算类型：0：APY；1：APR	String
tvl	总锁定价值	String
underlyingToken	质押代币	Struct
>isBaseToken	质押代币是否为主网基准代币	Boolean
>tokenContract	质押代币的智能合约地址	String
>tokenSymbol	质押代币标识	String
total	查询条件总数	String

请求示例#

shell

curl --location 'https://www.okx.com/api/v5/defi/explore/product/list' \
--header 'OK-ACCESS-KEY: 4b****53' \
--header 'OK-ACCESS-PASSPHRASE: p****d' \
--header 'Content-Type: application/json' \
--data '{
    "network":"ETH",
    "offset":"0",
    "limit":"10",
    "sort": {
        "orders":[
            {
                "direction":"DESC",
                "property":"TVL"
            }
        ]
    },
    "platformIds": ["89"]
}'

响应示例#

200

{
    "code": 0,
    "msg": "",
    "data": {
        "investments": [
            {
                "investmentId": "21033",
                "investmentName": "DAI",
                "chainId": "1",
                "rate": "0.04879",
                "investType": "4",
                "platformName": "MakerDAO",
                "platformId": "89",
                "poolVersion": "1",
                "rateType": "0",
                "tvl": "1211124903.92264",
                "underlyingToken": [
                    {
                        "tokenSymbol": "DAI",
                        "tokenAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
                        "isBaseToken": false
                    }
                ]
            }
        ],
        "total": "1"
    }
}