Sign in

v1

latestOpenAPI 3.1.2MIT2026-07-13589.5 KB
historical-rates

Get rates for a time period

Returns historical rates for every day within a time period starting from the provided date until today.

get/{start_date}..

Path parameters

start_datestring date required

Date in YYYY-MM-DD format, all dates stored in UTC.

Example:2024-01-15

The start date for the period

Query parameters

base'AUD' | 'BGN' | 'BRL' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KRW' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'PHP' | 'PLN' | 'RON' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'USD' | 'ZAR'

The base currency code following ISO4217

Base currency to convert from

symbolsBase[]

A list of currencies

Comma-separated list of currencies to convert to

Response

Historical rates for the period

amountnumber

The amount to convert

base'AUD' | 'BGN' | 'BRL' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KRW' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'PHP' | 'PLN' | 'RON' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'USD' | 'ZAR' required

The base currency code following ISO4217

start_datestring date required

Date in YYYY-MM-DD format, all dates stored in UTC.

end_datestring date required

Date in YYYY-MM-DD format, all dates stored in UTC.

ratesRatesByDate required

Mapping of date → rates object

Example response

{
  "start_date": "2024-01-15",
  "end_date": "2024-01-15",
  "rates": {
    "1999-01-04": {
      "AUD": 1.91
    },
    "1999-01-05": {
      "AUD": 1.8944
    },
    "1999-01-06": {
      "AUD": 1.882
    }
  }
}