> 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/dao-ru-jia-ge-jie-kou.md).

# 导入价格接口

### 接口概述

该接口用于批量导入价格数据到系统中，支持一次性导入多条价格数据。

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

### 请求头参数

<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 参数（JSON 格式）

<table><thead><tr><th>参数名</th><th width="105">类型</th><th width="82">必填</th><th>说明</th></tr></thead><tbody><tr><td>priceProviderId</td><td>String</td><td>是</td><td>价格源 ID<br>系统内创建 OpenAPI 类型的价格源后，可在详情页复制价格源ID</td></tr><tr><td>list</td><td>Array</td><td>是</td><td>包含多条价格记录的数组（每次最多支持 5000 条记录）</td></tr></tbody></table>

**list 数组元素**

<table><thead><tr><th width="133">参数名</th><th width="123">类型</th><th width="88">必填</th><th>说明</th></tr></thead><tbody><tr><td>asset</td><td>String</td><td>是</td><td>币种代码，需区分大小写，可从<a href="/pages/qT2urb03RW7LSHL5onWi">币种查询接口</a>获取当前 entity 所支持的币种</td></tr><tr><td>datetime</td><td>String</td><td>是</td><td>时间，格式为 <code>YYYY-MM-DD HH:mm:ss</code></td></tr><tr><td>price</td><td>Number</td><td>是</td><td>价格</td></tr></tbody></table>

#### 请求示例

```json
{
    "priceProviderId": "priceProviderId91",
    "list": [
        {
            "asset": "BTC",
            "datetime": "2024-11-18 00:00:00",
            "price": 10
        },
        {
            "asset": "ETH",
            "datetime": "2024-11-18 01:00:00",
            "price": 2000
        }
    ]
}

```

#### 响应参数

<table><thead><tr><th width="149">参数名</th><th width="117">类型</th><th>说明</th></tr></thead><tbody><tr><td>status</td><td>String</td><td>请求状态（如 <code>success</code>）</td></tr><tr><td>data</td><td>Boolean</td><td>请求结果（如 <code>true</code> 表示成功）</td></tr></tbody></table>

#### 响应示例

```json
{
    "status": "success",
    "data": true
}
```

### 在线调试

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

### 注意事项

1. **记录数量限制**：每次请求最多支持导入 5000 条价格记录。&#x20;
2. **时间格式**：`datetime` 参数必须严格按照 `YYYY-MM-DD HH:mm:ss` 格式，否则可能导致解析错误。
3. **币种区分大小写**：`asset` 参数需确保符合币种查询接口返回的标准，区分大小写。
4. **时区说明**：价格记录的时间将按照系统设置的时区进行处理，如有时区差异，请在导入前调整数据。
5. **数据完整性**：请确保每条价格记录数据完整且准确，避免因错误数据导致导入失败。
6. **价格精度**：`price` 参数的精度应符合实际业务需求，避免超出系统支持范围。