导入账户余额接口
接口概述
该接口用于批量导入账户的余额记录,支持一次性导入多个账户、多个币种、多个时间点的余额记录。
请求方式:
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 |
currency | String | 是 | 币种代码,需从币种查询接口获取,区分大小写 |
datetime | String | 是 | 余额时间,格式为 |
balance | Number | 是 | 余额数值 |
请求示例
响应参数
参数名 | 类型 | 说明 |
---|---|---|
success | Boolean | 导入任务是否成功 |
响应示例
注意事项
请求体限制:每次提交的余额记录条数限制为 1000 条。
时间格式:datetime 参数的格式必须严格按照 YYYY-MM-DD HH:mm:ss,否则可能导致解析错误。
时区说明:数据导入时,时区将和 Entity 设置的时区保持一致。如原始数据的时区和 Entity 时区不一致,需在导入前处理。
Last updated