---
title: "Get historical portfolio balances for an address."
method: GET
path: "/user/portfolio/{address}"
tags: ["Auxiliary"]
---

# Get historical portfolio balances for an address.

`GET /user/portfolio/{address}`

Get historical portfolio balances for an address. The default and only granularity is daily. The data is collected at a daily interval. The response is cached for 4 hours.

## Path parameters

- `address` string, required — The user's address

## Query parameters

- `start_timestamp` integer — Unix timestamp for the start of the time series data, trimmed to 8 decimal places.
- `end_timestamp` integer — Unix timestamp for the end of the time series data, trimmed to 8 decimal places

## Response `200`

OK

- UserPortfolioBalance[]
  - `balance_btc` string, required — The user's balance across all of Superform at this point in time, in BTC
  - `balance_eth` string, required — The user's balance across all of Superform at this point in time, in ETH
  - `balance_usd` string, required — The user's balance across all of Superform at this point in time, in USD
  - `timestamp` integer, required — Unix timestamp at which this user balance was calculated

## Other responses

- `default` — Error

---

[API](https://skmtc.net/superform/apis/superform-api.md) · [All operations](https://skmtc.net/superform/apis/superform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/superform/superform-api/versions/6eb27ced1c96/schema)