Convert - Monierate API

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

Body Params application/json

This endpoint accepts a JSON body containing three key fields:

from

string

required

The currency code of the source currency (e.g., USD, NGN).

string

required

The currency code of the target currency (e.g., EUR, GBP).

amount

integer

required

The amount to convert.

market

string

optional

We operate in three markets: official, mid, and parallel, with mid as the default

Example

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

status

string

required

message

string

required

data

object

required

request

object

required

rate

number

required

conversion

number

required

timestamp

number

required

Example

{
  "status": "success",
  "message": "retrieved",
  "data": {
    "request": {
      "from": "USD",
      "to": "NGN",
      "market": "parallel",
      "amount": 50
    },
    "rate": 1619.99,
    "conversion": 80999.5,
    "timestamp": 1738607282542
  }
}