On this page
Historical Range Data
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| Parameter | Type | Description |
|---|---|---|
| “from” | String | Listing code of the first asset (e.g. EUR) |
| “to” | String | Listing code of the second asset (e.g. USD) |
| “start” | Date | Start date of the daily rate range, using the YYYY-MM-DD format |
| “end” | Date | End 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-12Common 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"
}
]
}
}| Field | Type | Description |
|---|---|---|
| “success” | Boolean | HTTP Request is successful, if it’s false you have to handle the error |
| “lastUpdate” | DateTime | Latest data update time, depends on your subscription plan |
| “data” | Object | |
| “data”, “count” | Integer | Length of the result list |
| “data”, “list” | Array | Result list |
| “data”, “list”, <element>, “date” | Date | Reference date of the specified rate, using the YYYY-MM-DD format |
| “data”, “list”, <element>, “rate” | Decimal string | Midmarket 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.