导入价格接口

接口概述

该接口用于批量导入价格数据到系统中，支持一次性导入多条价格数据。新增按照资产代码传递资产信息的能力。（原有 V3 版本接口，必须使用 Elven 系统的资产 id 来传递资产信息）

• 请求方式：POST

• 请求 URL：https://openapi.elven.com/open/v4/price

请求头参数

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

查看详细说明

请求参数

Body 参数（JSON 格式）

参数名	类型	必填	说明
priceProviderId	String	是	价格源 ID 系统内创建 OpenAPI 类型的价格源后，可在详情页复制价格源ID
list	Array	是	包含多条价格记录的数组（每次最多支持 5000 条记录）

list 数组元素

参数名	类型	必填	说明
assetID	String	否	币种ID，需区分大小写，可从资产查询接口当前 entity 所支持的币种 assetID和symbol 至少填写一个 都填写时，只会识别assetID
symbol	String	否	币种symbol，需区分大小写，可从资产查询接口当前 entity 所支持的币种 assetID和symbol 至少填写一个 都填写时，只会识别assetID
datetime	String	是	时间，格式为 YYYY-MM-DD HH:mm:ss
price	Number	是	价格

请求示例

{
    "priceProviderId":"0LNz1biTPhUnftbgv8Yc7DwFdC0Nle6a",
    "list":[
        {
            "assetID":"BTC",
             "symbol":"",
            "datetime":"2024-11-20 00:00:00",
            "price":10
        },
         {
            "assetID":"",
             "symbol":"SOL",
            "datetime":"2024-11-20 00:00:00",
            "price":10
        }
    ]
}

响应参数

参数名	类型	说明
status	String	请求状态（如 success）
data	Boolean	请求结果（如 true 表示成功）

响应示例

```json
{
    "status": "success",
    "data": true,
    "requestId": "02952fee-a0e1-4e0a-b6a3-d3956516d0a6"
}
```

注意事项

1. 记录数量限制：每次请求最多支持导入 5000 条价格记录。

2. 时间格式：datetime 参数必须严格按照 YYYY-MM-DD HH:mm:ss 格式，否则可能导致解析错误。

3. 时区说明：价格记录的时间将按照系统设置的时区进行处理，如有时区差异，请在导入前调整数据。

4. 数据完整性：请确保每条价格记录数据完整且准确，避免因错误数据导致导入失败。

5. 价格精度：price 参数的精度应符合实际业务需求，避免超出系统支持范围。