---
title: "List historical account total value"
method: GET
path: "/accounts/{accountId}/balanceHistory"
tags: ["Account Information"]
---

# List historical account total value

`GET /accounts/{accountId}/balanceHistory`

## Request

- Base URL: `https://api.snaptrade.com`
- URL: `https://api.snaptrade.com/accounts/{accountId}/balanceHistory`
- Auth: API key in header `Signature` and API key in query parameter `clientId` and API key in query parameter `timestamp`

An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)

The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values.

## Path parameters

- `accountId` string, uuid, required: Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.

## Query parameters

- `userId` string, required: SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.
- `userSecret` string, required: SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the [rotate user secret endpoint](/reference/Authentication/Authentication_resetSnapTradeUserSecret).

## Response `200`

OK

- AccountValueHistoryResponse: The response to the account value history endpoint, containing a list of estimated account values at different points in time.
  - `history` AccountValueHistoryItem[]: List of estimated account values over time returned by the endpoint. The data may contain gaps and is best used for charting trends, rather than as a complete or exact record of historical account values.
    - `date` string, date: The date of the estimated account value
    - `total_value` string: Estimate of the total market value of this account (includes cash, equity, fixed income, etc) at the given date.
  - `currency` string: The ISO-4217 currency code for the account values.

## Other responses

- `403`: Forbidden

## Changes

- **2026-10-14** `efd73af6c911`: 2 breaking
  - the `default_code` response's property type changed from `string` to no type for status `403`
  - the `detail` response's property type changed from `string` to no type for status `403`
- **2026-10-14** `07c9022b410a`: 2 breaking
  - the `default_code` response's property type changed from no type to `string` for status `403`
  - the `detail` response's property type changed from no type to `string` for status `403`
- **2026-04-30** `df1cc6f9b67f`: 2 info
  - api tag `Account Information` added
  - api tag `Experimental endpoints` removed
- **2026-03-06** `6a3b37154f49`: 2 info
  - api tag `Experimental endpoints` added
  - api tag `Account Information` removed

[Operation history](https://skmtc.dev/passiv/apis/snaptrade/changes/accounts/:accountId/balanceHistory/get.md)

---

[API](https://skmtc.dev/passiv/apis/snaptrade.md) - [All operations](https://skmtc.dev/passiv/apis/snaptrade/llms.txt) - [OpenAPI document](https://skmtc.dev/passiv/apis/snaptrade/revisions/60be624d75b7?raw)