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

Convert

POST
/rates/convert.json
This endpoint allows the conversion of a specified amount from one currency to another. It uses current exchange rates to calculate the equivalent value of the source currency in the target currency.
Body Example:
{
  "from": "USD",
  "to": "EUR",
  "amount": 100,
  "market": "mid"
}
This endpoint accepts a JSON body containing three key fields:
from (string): The currency code of the source currency (e.g., "USD" for US Dollar).
to (string): The currency code of the target currency (e.g., "EUR" for Euro).
amount (integer): The amount to be converted.
market We support three rates: official, mid, and parallel, with mid as the default. Note that some rates may not be available in a particular market (which may result in an error response), use the Latest endpoint to see all rates available in a market.

Request

Authorization
API Key
Add parameter in header
api_key
Example:
api_key: ********************
or
Body Params application/json

Example
{
    "from": "USD",
    "to": "NGN",
    "amount": 50
}

Request Code 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 POST 'https://api.monierate.com/core/rates/convert.json' \
--header 'api_key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from": "USD",
    "to": "NGN",
    "amount": 50
}'

Responses

🟢200Success
application/json
Body

Example
{
    "status": "success",
    "message": "retrieved",
    "data": {
        "request": {
            "from": "USD",
            "to": "NGN",
            "market": "parallel",
            "amount": 50
        },
        "rate": 1619.99,
        "conversion": 80999.5,
        "timestamp": 1738607282542
    }
}
Modified at 2025-07-07 08:32:18
Previous
Currencies
Next
History
Built with