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.