GET
/
core
/
assets
/
{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"
      }
    ]
  }
}

There is a specific set of assets allowed for the ?to query parameter, 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 contact us.

If the ?to query parameter is not specified, it will default to:

  • The user’s country currency, if the authenticated subject is a user.
  • USD, in all other cases.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Path Parameters

​
asset
string
required

The asset code.

Minimum length: 1

Query Parameters

​
to
string

The asset code to which historical rates are requested.

Minimum length: 1
​
interval
enum<string>
required

The interval for the historical rates.

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

Response

200
application/json
Historical rates retrieved.
​
historicalRates
object