导入账户余额接口

接口概述

该接口用于批量导入账户的余额记录，支持一次性导入多个账户、多个币种、多个时间点的余额记录。新增按照资产代码传递资产信息的能力。（原有 V3 版本接口，必须使用 Elven 系统的资产 id 来传递资产信息）

• 请求方式：POST

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

请求头参数

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

查看详细说明

请求参数

Body 参数（JSON 数组）

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

余额记录对象

参数名	类型	必填	说明
entityAccountId	String	是	账户的主键 ID
assetID	String	否	币种ID，需区分大小写，可从资产查询接口当前 entity 所支持的币种 assetID和symbol 至少填写一个 都填写时，只会识别assetID
symbol	String	否	币种代码，需区分大小写，可从资产查询接口当前 entity 所支持的币种 assetID和symbol 至少填写一个 都填写时，只会识别assetID
datetime	String	是	余额时间，格式为 YYYY-MM-DD HH:mm:ss 将按照 Entity 设置的时区进行处理
balance	Number	是	余额数值

请求示例

[
    {
        "entityAccountId": "w597WQZ5SzfKegoGB8qF1XRA2D39dr0U",
        "assetID": "BTC",
        "symbol": "",
        "datetime": "2020-01-01 11:11:11",
        "balance": 10
    },
    {
        "entityAccountId": "19jQnm3AQaUGMI6Kn2YvqtN9kje8yXic",
        "assetID": "",
        "symbol": "SOL",
        "datetime": "2020-01-01 11:11:11",
        "balance": 10
    }
]

响应参数

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

响应示例

{
    "status": "success",
    "data": true,
    "requestId": "3f785786-a5a4-4907-8674-e6784bcc92ea"
}

在线调试

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

注意事项

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

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

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