Balance history data

GET

/ver1/accounts/:account_id/balance_chart_data

Permission: ACCOUNTS_READ

Security: SIGNED

Returns the balance history for a specific account using its ID.

By replacing account_id with summary, you can use the /ver1/accounts/summary/balance_chart_data endpoint to retrieve aggregated data for all accounts where available_include_in_summary is set to true.

---

Path Parameter

account_idintegerrequired

Unique 3Commas ID of this exchange account entity.

Query Parameters

date_fromstringrequired

Specifying the start date in ISO 8601 format for the required records.

date_tointeger

Specifies the end date for the required records.

Example Request

GET

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

Response Parameters

datestring

Timestamp (UNIX time) in seconds representing a specific date.

usdstring

The value in USD for a specific date.

btcstring

The value in BTC for a specific date.

btc_deposit_amountstring

The deposited amount in BTC on a specific date.

usd_deposit_amountstring

The deposited amount in USD on a specific date.

Example Responses

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
  }
]

400 Bad Request

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