Skip to main content
GET
/
core
/
assets
/
{asset}
/
rates
Get asset rates
curl --request GET \
  --url https://api.enterprise.sandbox.uphold.com/core/assets/{asset}/rates \
  --header 'Authorization: Bearer <token>'
{
  "rates": {
    "ETH": {
      "ask": "22.910619213684715739",
      "bid": "22.85842248147463121064",
      "mid": "22.88452084757967347482"
    },
    "GBP": {
      "ask": "47027.64159916551332431855",
      "bid": "46908.53407930127413227339",
      "mid": "46968.08783923339372829597"
    },
    "USD": {
      "ask": "61023.8527432818",
      "bid": "60946.4628910217",
      "mid": "60985.15781715175"
    }
  }
}

​
Denomination

The denomination query parameter allows you to denominate rates against one or multiple assets. If no value is set for this parameter, the rates for all available assets will be returned. 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.

​
Retrieving multiple asset rates at once

You can use the denomination currency as a proxy for retrieving the specific asset rates you’re interested in. This way, you won’t have to:
  • Make one Get Asset Rates request per each asset rate desired
  • Discard all the undesired assets rates retrieved by default
For example, if you want to get the rates for BTC and ETH in USD:
  1. Define asset as USD
  2. Set denomination as the list of desired assets: BTC,ETH
  3. Calculate the inverse for each returned asset rate: 1rate\frac{1}{\text{rate}}
You can specify up to 100 asset codes in the denomination parameter per request.

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[]

Filter rates by specified assets.

Maximum array length: 100
Minimum string length: 1

Response

Asset rates retrieved.

​
rates
object