导入价格接口

接口概述

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

• 请求方式：POST

• 请求 URL：https://openapi.elven.com/open/v3/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 数组元素

参数名	类型	必填	说明
asset	String	是	币种代码，需区分大小写，可从币种查询接口获取当前 entity 所支持的币种
datetime	String	是	时间，格式为 YYYY-MM-DD HH:mm:ss
price	Number	是	价格

请求示例

{
    "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
        }
    ]
}

响应参数

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

响应示例

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

在线调试

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

注意事项

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

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

3. 币种区分大小写：asset 参数需确保符合币种查询接口返回的标准，区分大小写。

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

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

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