导入账户余额接口

接口概述

该接口用于批量导入账户的余额记录,支持一次性导入多个账户、多个币种、多个时间点的余额记录。

  • 请求方式POST

  • 请求 URLhttps://openapi.elven.com/open/v3/account/treasuryBalance

请求头参数

参数名类型必填说明

elven-api-key

String

分配给您的API密钥

elven-api-sign

String

请求签名,用于验证请求合法性

elven-api-timestamp

String

请求时间戳,毫秒级

查看详细说明

请求参数

Body 参数(JSON 数组)

请求体是一个 JSON 数组,每个元素为一个余额记录对象。

余额记录对象

参数名类型必填说明

entityAccountId

String

账户的主键 ID

currency

String

币种代码,需从币种查询接口获取,区分大小写

datetime

String

余额时间,格式为 YYYY-MM-DD HH:mm:ss 将按照 Entity 设置的时区进行处理

balance

Number

余额数值

请求示例

[
    {
        "entityAccountId": "accountId123",
        "currency": "BTC",
        "datetime": "2023-01-01 01:01:01",
        "balance": 10.5
    },
    {
        "entityAccountId": "accountId456",
        "currency": "ETH",
        "datetime": "2023-01-02 02:02:02",
        "balance": 20
    }
]

响应参数

参数名类型说明

success

Boolean

导入任务是否成功

响应示例

{
    "success": true
}

注意事项

  • 请求体限制:每次提交的余额记录条数限制为 1000 条。

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

  • 时区说明:数据导入时,时区将和 Entity 设置的时区保持一致。如原始数据的时区和 Entity 时区不一致,需在导入前处理。

Last updated