Skip to main content
GET
/
core
/
assets
/
{asset}
/
historical-rates
Get asset historical rates
curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates \
  --header 'Authorization: Bearer <token>'
{
  "historicalRates": {
    "BTC": [
      {
        "rate": {
          "mid": "27649.1865680048064515576"
        },
        "timestamp": "2021-07-01T00:00:00Z"
      },
      {
        "rate": {
          "mid": "28000.1234567890123456789"
        },
        "timestamp": "2021-07-02T00:00:00Z"
      }
    ]
  }
}

​
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. For a more detailed explanation of the denomination concept, check the Core Concepts page.

​
Interval

The interval query parameter determines the overall timespan of historical data and the frequency at which data points are added (rolled up). 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 data30 seconds
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
five-yearsPast five years of historical data1 week

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Path Parameters

​
asset
string
required

The asset code.

Minimum string length: 1

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 string length: 1
​
interval
enum<string>
default:one-day

The interval for the historical rates.

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

Response

Historical rates retrieved.

​
historicalRates
object