Obtain a list of all the currently available conversion rates using USD (Dollar) as the default base currency.

In the following example, 1 USD = 0.895772375876783 EUR.

HTTP Request:

GET /live

ParameterTypeDescription
“type”String enum(Optional) Get only the specified type of assets, can be currency, crypto, material
“assets[]”String array(Optional) Get only the specified assets listing codes

HTTP Request Example:

GET /live?type=currency&assets[]=USD&assets[]=EUR

Common Errors:

  • 400, “INVALID_PARAMETER”

Example of successful response:

{
  "success": true,
  "lastUpdate": "2024-08-26T14:10:27.01329941Z",
  "data": {
    "count": 220,
    "list": [
      {
        "code": "USD",
        "rate": "1"
      },
      {
        "code": "EUR",
        "rate": "0.895772375876783"
      },
      ...
    ]
  }
}
FieldTypeDescription
“success”BooleanHTTP Request is successful, if it’s false you have to handle the error
“lastUpdate”DateTimeLatest data update time, depends on your subscription plan
“data”Object
“data”, “count”IntegerLength of the result list
“data”, “list”ArrayResult list
“data”, “list”, <element>, “code”StringListing code of the target asset
“data”, “list”, <element>, “rate”Decimal stringCurrent conversion midmarket rate

⚠️ The decimal values are passed as strings to avoid loss of precision during the data transfer and JSON decode. You could parse them into a floating point value, but we advise you to use something like BigInteger.


Different Base Currency

Results can also be obtained in another base currency for conversion rates (other than the default USD).

In the following example, 1 EUR = 1.11669349969065 USD.

HTTP Request:

GET /live/base/{code}

HTTP Request Example:

GET /live/base/EUR?type=currency&assets[]=USD&assets[]=EUR

ParameterTypeDescription
“type”String enum(Optional) Get only the specified type of assets, can be currency, crypto, material
“assets[]”String array(Optional) Get only the specified assets listing codes

Common Errors:

  • 400, “INVALID_PARAMETER”
  • 404, “BASE_ASSET_NOT_FOUND”

Example of successful response:

{
  "success": true,
  "lastUpdate": "2024-08-26T14:26:12.913765779Z",
  "data": {
    "count": 220,
    "list": [
      {
        "code": "USD",
        "rate": "1.11669349969065"
      },
      {
        "code": "EUR",
        "rate": "1"
      },
      ...
    ]
  }
}