> 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/ping-tai-cha-xun-jie-kou.md).

# 平台查询接口

### 接口概述

该接口用于查询系统中的平台列表，支持分页和关键字模糊搜索。

* **请求方式**：`GET`
* **请求 URL**：`https://openapi.elven.com/open/v3/platform`

### 请求头参数

<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)

### 请求参数

#### Query 参数

<table><thead><tr><th width="202">参数名</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>keyword</td><td>String</td><td>否</td><td>模糊搜索的关键字，不区分大小写</td></tr></tbody></table>

#### 请求示例

```bash
s
```

### 响应参数

<table><thead><tr><th width="129">参数名</th><th width="96">类型</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="132">参数名</th><th width="100">类型</th><th>说明</th></tr></thead><tbody><tr><td>platformId</td><td>String</td><td>平台的主键 ID</td></tr><tr><td>name</td><td>String</td><td>平台名称</td></tr><tr><td>type</td><td>String</td><td><p>平台类型</p><p>取值为：<code>CHAIN</code>、<code>BANK</code>、<code>EXCHANGE</code>、<code>CUSTODY</code>、<code>PAYMENT</code></p></td></tr></tbody></table>

#### 响应示例

```json
{
    "total": 2,
    "list": [
        {
            "platformId": "platformId123",
            "name": "Bitcoin Network",
            "type": "CHAIN"
        },
        {
            "platformId": "platformId456",
            "name": "Bank of America",
            "type": "BANK"
        }
    ]
}
```

### 在线调试

您可以通过 Apifox 服务进行接口的在线调试：<https://zswsuv3jhf.apifox.cn/api-253901220>

### 注意事项

* 请求头中的 **elven-api-key**、**elven-api-sign** 和 **elven-api-timestamp** 为必填参数，用于验证请求的合法性和安全性。
* **page**、**limit**、**keyword** 参数为可选参数，不传递时默认返回第一页，每页 10 条数据，不进行关键字过滤。
