Available only in plans starting from MINIMAL

Obtain a list of all the daily conversion rates of a specified asset pairs using a custom time range.

The maximum time range specified in a single request is 100 days.

HTTP Request:

GET /history/range/daily

ParameterTypeDescription
“from”StringListing code of the first asset (e.g. EUR)
“to”StringListing code of the second asset (e.g. USD)
“start”DateStart date of the daily rate range, using the YYYY-MM-DD format
“end”DateEnd date of the daily rate range, using the YYYY-MM-DD format

⚠️ Minimum supported date is 2000-01-01


HTTP Request Example (EUR-USD pair):

GET /history/range/daily?from=EUR&to=USD?start=2023-01-09&end=2023-01-12

Common Errors:

  • 400, “INVALID_PARAMETER”

Example of successful response:

{
  "success": true,
  "lastUpdate": "2024-08-27T00:00:00Z",
  "data": {
    "count": 4,
    "list": [
      {
        "date": "2023-01-09",
        "rate": "1.075709892180262"
      },
      {
        "date": "2023-01-10",
        "rate": null
      },
      {
        "date": "2023-01-11",
        "rate": "1.074434285403087"
      },
      {
        "date": "2023-01-12",
        "rate": "1.0823576976472"
      }
    ]
  }
}
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>, “date”DateReference date of the specified rate, using the YYYY-MM-DD format
“data”, “list”, <element>, “rate”Decimal stringMidmarket rate of the target date, if it’s null the value is missing for the request date

⚠️ 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.