> For the complete documentation index, see [llms.txt](https://docs.elven.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.com/v3/chinese/openapi/v3/zi-chan-cha-xun-jie-kou.md).

# 资产查询接口

### 接口概述

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

* **请求方式**：`POST`
* **请求 URL**：`https://openapi.elven.com/open/v3/asset/search`

### 请求头参数

<table><thead><tr><th width="202">参数名</th><th width="90">类型</th><th width="64">必填</th><th>说明</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>是</td><td>分配给您的API密钥</td></tr><tr><td>elven-api-sign</td><td>String</td><td>是</td><td>请求签名，用于验证请求合法性</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>是</td><td>请求时间戳，毫秒级</td></tr></tbody></table>

[查看详细说明](https://docs.elven.com/v3/openapi/jie-kou-shou-quan#elven-api-sign)

### 请求参数

#### Body 参数

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

#### 请求示例

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

### 响应参数

<table><thead><tr><th width="209">参数名</th><th width="94">类型</th><th>说明</th></tr></thead><tbody><tr><td>status</td><td>String</td><td>请求状态，值为 “success” 或 “failed”</td></tr><tr><td>data</td><td>Object</td><td>返回的主要数据</td></tr><tr><td>requestId</td><td>String</td><td>请求的唯一标识符</td></tr></tbody></table>

#### data

<table><thead><tr><th width="209">参数名</th><th width="94">类型</th><th>说明</th></tr></thead><tbody><tr><td>total</td><td>Number</td><td>查询到的的资产总数</td></tr><tr><td>list</td><td>Array</td><td>包含资产详细信息的数组</td></tr></tbody></table>

#### list 数组元素

<table><thead><tr><th width="210">参数名</th><th width="91">类型</th><th>说明</th></tr></thead><tbody><tr><td>assetId</td><td>String</td><td>币种名称</td></tr><tr><td>assetName</td><td>String</td><td>资产代码，例如 <code>Bitcoin</code></td></tr><tr><td>symbol</td><td>String</td><td>资产代码，例如 <code>BTC</code></td></tr><tr><td>type</td><td>String</td><td>资产类型，取值为：<code>CRYPTO</code> 或 <code>FIAT</code></td></tr></tbody></table>

#### 响应示例

```json
{
    "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 条数据，不进行关键字过滤。