资产查询接口

接口概述

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

  • 请求方式POST

  • 请求 URLhttps://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

资产类型,取值为:CRYPTOFIAT

响应示例

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

注意事项

  • 请求头中的 elven-api-keyelven-api-signelven-api-timestamp 为必填参数,用于验证请求的合法性和安全性。

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

Last updated

Was this helpful?