资产查询接口

接口概述

该接口用于查询系统中支持的资产列表，支持分页和关键字搜索，支持仅查询自定义资产。

• 请求方式：POST

• 请求 URL：https://openapi.elven.com/open/v3/asset/search

请求头参数

参数名	类型	必填	说明
elven-api-key	String	是	分配给您的API密钥
elven-api-sign	String	是	请求签名，用于验证请求合法性
elven-api-timestamp	String	是	请求时间戳，毫秒级

查看详细说明

请求参数

Body 参数

参数名	类型	必填	说明
page	Number	否	页码，为空视认 1
limit	Number	否	每页条数，为空视为 10
assetType	String	否	ALL：查询所有资产数据，包括系统和自定义资产 SYSTEM：只查询系统资产数据 CUSTOM：只查询自定义资产数据可以为空，为空视为 all
symbol	String	否	搜索的关键字，对资产符号进行搜索
like	Boolean	否	是否精准匹配 为空视为 false false：模糊匹配，且大小写不敏感 true：精准匹配，且大小写敏感

请求示例

{
	"symbol": "BTC",
	"like": false,
	"page":1,
	"limit":100,
	"assetType":""
}

响应参数

参数名	类型	说明
status	String	请求状态，值为 “success” 或 “failed”
data	Object	返回的主要数据
requestId	String	请求的唯一标识符

data

参数名	类型	说明
total	Number	查询到的的资产总数
list	Array	包含资产详细信息的数组

list 数组元素

参数名	类型	说明
assetId	String	币种名称
assetName	String	资产代码，例如 Bitcoin
symbol	String	资产代码，例如 BTC
type	String	资产类型，取值为：CRYPTO 或 FIAT

响应示例

{
    "status": "success",
    "data": {
        "total": 1,
        "list": [
            {
                "assetId": "BTC",
                "assetName": "Bitcoin",
                "symbol": "BTC",
                "type": "CRYPTO"
            }
        ]
    },
    "requestId": "659f96a5-d394-4274-a59c-5027f98f662d"
}

注意事项

• 请求头中的 elven-api-key、elven-api-sign 和 elven-api-timestamp 为必填参数，用于验证请求的合法性和安全性。

• page、limit、symbol 参数为可选参数，不传递时默认返回第一页，每页 10 条数据，不进行关键字过滤。