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

# List historical account total value

`GET /accounts/{accountId}/balanceHistory`

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.

## 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.
    - `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

---

[API](https://skmtc.net/passiv/apis/snaptrade.md) · [All operations](https://skmtc.net/passiv/apis/snaptrade/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/passiv/snaptrade/revisions/993e058b557e/schema)