GET
/
core
/
portfolio
/
historical-balance
Get historical balance
curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/portfolio/historical-balance \
  --header 'Authorization: Bearer <token>'
{
  "historicalBalance": [
    {
      "timestamp": "2025-06-25T09:50:00Z",
      "balance": {
        "total": "67785.67",
        "available": "67785.67"
      }
    },
    {
      "timestamp": "2025-06-25T10:00:00Z",
      "balance": {
        "total": "67801.77",
        "available": "67801.77"
      }
    }
  ]
}

​
Denomination

The denomination query parameter allows you to denominate rates against another asset. If no value is set for this parameter, it defaults to USD. There is a specific set of assets allowed, including but not limited to: USD, EUR, GBP, AUD, CAD, NZD, MXN, and BTC. If you need a particular asset added to this list, please reach out to your Account Manager.

​
Interval

The interval query parameter determines the overall timespan of historical data and the frequency of the data points (rollup frequency). Each interval value defines how far back in time the data spans, and how granular each returned data point is within that range:
IntervalDescriptionRollup Frequency
one-hourPast hour of historical data1 minute
one-dayPast day of historical data10 minutes
one-weekPast week of historical data1 hour
one-monthPast month of historical data6 hours
one-yearPast year of historical data2 days

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Query Parameters

​
denomination
string
default:USD

Specifies the asset code to use as the denomination for value conversion. If not provided, USD is used by default.

Minimum length: 1
​
interval
enum<string>
default:one-day

The interval for the portfolio historical data.

Available options:
one-hour,
one-day,
one-week,
one-month,
one-year

Response

200
application/json

Portfolio historical balance retrieved.

The response is of type object.