Get asset historical rates

curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "historicalRates": {
    "BTC": [
      {
        "rate": {
          "mid": "27649.1865680048064515576"
        },
        "timestamp": "2021-07-01T00:00:00.000Z"
      },
      {
        "rate": {
          "mid": "28000.1234567890123456789"
        },
        "timestamp": "2021-07-02T00:00:00.000Z"
      }
    ]
  }
}

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>'

import requests

url = "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/historical-rates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "historicalRates": {
    "BTC": [
      {
        "rate": {
          "mid": "27649.1865680048064515576"
        },
        "timestamp": "2021-07-01T00:00:00.000Z"
      },
      {
        "rate": {
          "mid": "28000.1234567890123456789"
        },
        "timestamp": "2021-07-02T00:00:00.000Z"
      }
    ]
  }
}

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:

Interval	Description	Rollup Frequency
`one-hour`	Past hour of historical data	30 seconds
`one-day`	Past day of historical data	10 minutes
`one-week`	Past week of historical data	1 hour
`one-month`	Past month of historical data	6 hours
`one-year`	Past year of historical data	2 days
`five-years`	Past five years of historical data	1 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

Show child attributes

⌘I

Core API

KYC Connector API

Market Pulse API

Widgets API

Topper API

Get asset historical rates

Denomination

Interval

Authorizations

Path Parameters

Query Parameters

Response

​Denomination

​Interval

Authorizations

Path Parameters

Query Parameters

Response

Denomination

Interval