导入账户余额接口
接口概述
该接口用于批量导入账户的余额记录,支持一次性导入多个账户、多个币种、多个时间点的余额记录。新增按照资产代码传递资产信息的能力。(原有 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
sourceId
String
否
存储到哪个余额 source 下 不填写时,会自动在对应账户下创建新的余额 source
assetID
String
否
symbol
String
否
datetime
String
是
余额时间,格式为 YYYY-MM-DD HH:mm:ss
将按照 Entity 设置的时区进行处理
balance
Number
是
余额数值
请求示例
[
{
"entityAccountId": "w597WQZ5SzfKegoGB8qF1XRA2D39dr0U",
"sourceId": "IH1ty3XJlOuHWDEAsQrTn0xkJ4hS319L",
"assetID": "BTC",
"symbol": "",
"datetime": "2020-01-01 11:11:11",
"balance": 10
},
{
"entityAccountId": "19jQnm3AQaUGMI6Kn2YvqtN9kje8yXic",
"sourceId": "IH1ty3XJlOuHWDEAsQrTn0xkJ4h1219L",
"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 时区不一致,需在导入前处理。
Last updated
Was this helpful?