导入账户余额接口

接口概述

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

• 请求方式：POST

• 请求 URL：https://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
sourceId	String	否	存储到哪个余额 source 下 不填写时，会自动在对应账户下创建新的余额 source
currency	String	是	币种代码，需区分大小写，可从币种查询接口获取当前 entity 所支持的币种
datetime	String	是	余额时间，格式为 YYYY-MM-DD HH:mm:ss 将按照 Entity 设置的时区进行处理
balance	Number	是	余额数值

请求示例

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

响应参数

参数名	类型	说明
success	Boolean	导入任务是否成功

响应示例

{
    "success": true
}

在线调试

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

注意事项

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

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

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