API Introduction

Monierate provides a simple, lightweight, and portable JSON API with live and historical foreign exchange (forex) rates. Our API is easy to integrate, with data sourced from multiple reliable providers, blended algorithmically to ensure accuracy and consistency.

Monierate's exchange rates are unbiased and consistent, with no complex queries or confusing authentication methods. Historical end-of-day rates are available from January 1, 2025.

Common Use Cases

Currency trading and brokerage services (OnRamp and Offramp).

E-commerce and shopping websites.

Cross border payments

Account and General Finance.

Analysis & Analytics.

Academic Research

Open Source Projects

Connecting to the API

Our API delivers data in JSON format via HTTPS. It's accessible with any language or framework that supports HTTP requests.

Supported Integration Methods

HTTP GET requests via browsers, server scripts, or client apps

Any programming language capable of making HTTP requests

Note: WebSockets and push notifications are not supported currently.

URL Format

The base path is:

https://api.monierate.com/core

Example Endpoints:

latest.json – Latest exchange rates

currencies.json – List of supported currencies

convert.json – Converts between currencies

Example Request

https://api.monierate.com/core/rates/latest.json?api_key=YOUR_API_KEY&base=USD

or, if api_key is passed in headers.

curl --location 'https://api.monierate.com/core/rates/latest.json?base=USD' \
--header 'api_key: YOUR_API_KEY'

Authentication

The API key can be sent in the following ways depending on the request:

In the header as Authorization or api_key

In the URL as api_key

Query Parameters

api_key (required if not in request header): Your unique API key

base (optional): Base currency (default: USD)

API Response Format

Responses are returned as JSON over HTTPS.

Example Response (latest.json)

{
    "timestamp": 1706908800,
    "base": "USD",
    "rates": {
        "AED": 3.6725,
        "AFN": 77.8500,
        "ALL": 102.5000,
        "AMD": 478.1500,
        "ANG": 1.7900,
        "AOA": 135.3000,
        "ARS": 98.4500,
        "AUD": 1.4200
    }
}

Additional Endpoints

currencies.json – Returns all supported currencies

convert.json – Converts currency based on current or historical rates

Error Handling

Invalid requests will return a JSON error message detailing the issue.

For more details, refer to specific sections of our documentation or contact support at hello@monierate.com.

Common Use Cases#

Connecting to the API#

Supported Integration Methods#

URL Format#

Example Request#

Authentication#

Query Parameters#

API Response Format#

Example Response (latest.json)#

Additional Endpoints#

Error Handling#