Import Account Balances

API Overview

This API is used to batch import balance records for accounts, supporting multiple accounts, currencies, and timestamps in a single request.

• Request Method：POST

• Request URL：https://openapi.elven.com/open/v3/account/treasuryBalance

Request Headers

Parameter Name	Type	Required	Description
elven-api-key	String	Yes	The API key assigned to you
elven-api-sign	String	Yes	Request signature, used to verify the legitimacy of the request
elven-api-timestamp	String	Yes	Request timestamp, in milliseconds

View Details

Request Parameters

Body Parameters (JSON Array)

The request body is a JSON array, where each element is a balance record object.

Balance Record Object

Parameter Name	Type	Required	Description
entityAccountId	String	Yes	The primary key of the account associated with the balance.
currency	String	Yes	Transaction currency, which can be obtained from the currency query API. Case-sensitive.
datetime	String	Yes	The timestamp of the balance record in YYYY-MM-DD HH:mm:ss format.
balance	Number	Yes	The balance amount for the specified account and currency.

Example Request

[
    {
        "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
    }
]

Response Parameters

Parameter Name	Type	Description
success	Boolean	Import Task Status

Example Response

{
    "success": true
}

Notes

• Record Limit: The number of balance records in the request body is limited to 1000 records per request.

• Datetime Format: The datetime field must strictly follow the format YYYY-MM-DD HH:mm:ss. Parsing errors may occur if the format is incorrect.

• Time Zone Alignment: The imported data will be aligned with the time zone of the associated Entity. If the original data uses a different time zone, it must be adjusted before import.