Balance history data

Description: Returns the balance history for a specific account using its ID

Permission: ACCOUNTS_READ Security: SIGNED

---

GET

/ver1/accounts/{account_id}/balance_chart_data

---

Path Parameter

account_id integer required Unique 3Commas ID for this exchange account entity

Request Parameters

date_from string required Specifying the start date in ISO 8601 format for the required records

date_to integer Specifies the end date for the required records

Parameters response

date_to string Timestamp (UNIX time) in seconds representing a specific date

usd string The value in USD for a specific date

btc string The value in BTC for a specific date

btc_deposit_amount string The deposited amount in BTC on a specific date

usd_deposit_amount string The deposited amount in USD on a specific date

Example Request

 GET /ver1/accounts/12345678/balance_chart_data?date_from=2024-09-18T18:58:55.469Z

Example Response and errors

Status: 200 OK

[
    {
        "date": 1726617600,
        "usd": 28.59,
        "btc": 0.000475,
        "btc_deposit_amount": 0.0,
        "usd_deposit_amount": 0.0
    },
    ...
    {
        "date": 1727873800,
        "usd": 29.31,
        "btc": 0.000481,
        "btc_deposit_amount": 0.0,
        "usd_deposit_amount": 0.0
    }
]

Status: 400 Bad Request

```json { "error": "record_invalid", "error_description": "Invalid parameters", "error_attributes": { "date_from": [ "is invalid" ] } } ```