> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/account/balance-history-data.md).

# Balance history data

**Description:** Returns the balance history for a specific account using its ID<br>

**Permission:** ACCOUNTS\_READ\
**Security:** SIGNED\ <br>

***

<mark style="color:blue;">**GET**</mark>

<mark style="color:blue;">**/ver1/accounts/{account\_id}/balance\_chart\_data**</mark>

***

\ <br>

## Path Parameter<br>

**account\_id**     `integer`     <mark style="color:orange;">required</mark>\
Unique 3Commas ID for this exchange account entity

## Request Parameters<br>

**date\_from**     `string`     <mark style="color:orange;">required</mark>\
Specifying the start date in ISO 8601 format for the required records

**date\_to**     `integer`\
Specifies the end date for the required records

\ <br>

## Parameters response<br>

**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

\ <br>

## Example Request<br>

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

\ <br>

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

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

</details>

<details>

<summary>Status: 400 Bad Request</summary>

\
\`\`\`json { "error": "record\_invalid", "error\_description": "Invalid parameters", "error\_attributes": { "date\_from": \[ "is invalid" ] } } \`\`\`

</details>