Monierate API
HomeIntrodutionGet API key
HomeIntrodutionGet API key
  1. Exchange Rates Endpoints
  • API Introduction
  • Authentication
  • Supported Currencies
  • Errors
  • Exchange Rates Endpoints
    • Latest rate
      GET
    • Platforms
      GET
    • Currencies
      GET
    • Convert
      POST
    • History
      GET
  1. Exchange Rates Endpoints

History

Developing
GET
/history.json
Retrieve historical exchange rates for any available date, dating back to January 1st, 1999.
Similar to latest.json, the /historical/ route returns a standard response object containing all conversion rates for available symbols/currencies on the requested date, labeled by their international-standard 3-letter ISO currency codes.
The historical rates provided are the last values published for a given UTC day (up to and including 23:59:59 UTC), excluding the current UTC date.

Log in to view full request history#

Time | Status | User Agent
Make a request to see history.
The base property contains the 3-letter currency code for which all exchange rates are relative. This base currency is also included in the rates object by default (e.g., "USD": 1).
The rates property is an object (hash/dictionary/associative array) containing all the conversion or exchange rates for all available (or requested) currencies, labeled by their international-standard 3-letter currency codes. All values are relative to one unit of the requested base currency.
The timestamp property indicates the UNIX time when the rates were published. (If you’re using the timestamp in JavaScript, multiply it by 1000, as JavaScript uses milliseconds instead of seconds.)

📘 Additional Parameters#

Changing the base currency and requesting specific symbols is available for clients on the Developer, Enterprise, and Unlimited plans.

🚧 Historical Timezones & Daylight Saving Time#

For consistency, all dates and timestamps in the Monierate API are in UTC timezone (GMT+00:00), with no daylight saving applied.
If your server/integration operates in a different timezone (or supports multiple timezones), you should convert your server's local time to the equivalent UTC time before making your request.

🚧 Historical requests for the current day's UTC date#

Historical rates are generally the last values we published on a given UTC day (up to and including 23:59:59 UTC), with the exception of the current UTC date.
If you make a request for the current day's historical file, you will receive the most recent rates available for your subscription plan at that moment, as the day is not yet complete (therefore in such cases, the values returned would be the same as you would find via our latest.json endpoint).
This behavior was added early on in response to client feedback, ensuring that the historical endpoint always provides a value for a valid date (even if it is today's date and no end-of-day values are available).
If you wish to obtain rates for a historical date that is the same as today's date (in UTC), you may prefer to use the latest.json endpoint instead to avoid unexpected behavior.

Request

None

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.monierate.com/core/history.json'

Responses

🟢200Success
application/json
Body
object {0}
Example
{}
Previous
Convert
Built with