Exchange rates and currency conversion
POSThttps://api.m3o.com/v1/currency/Codes
Codes returns the supported currency codes for the API
codes object array
Request
curl "https://api.m3o.com/v1/currency/Codes" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{}'
Response
{
"codes": [
{
"name": "AED",
"currency": "UAE Dirham"
},
{
"name": "AFN",
"currency": "Afghan Afghani"
},
{
"name": "ALL",
"currency": "Albanian Lek"
},
{
"name": "AMD",
"currency": "Armenian Dram"
},
{
"name": "ANG",
"currency": "Netherlands Antillian Guilder"
}
]
}POSThttps://api.m3o.com/v1/currency/Convert
Convert returns the currency conversion rate between two pairs e.g USD/GBP
amount number
optional amount to convert e.g 10.0
from string
base code to convert from e.g USD
to string
target code to convert to e.g GBP
amount number
converted amount e.g 7.10
from string
the base code e.g USD
rate number
conversion rate e.g 0.71
to string
the target code e.g GBP
Request
curl "https://api.m3o.com/v1/currency/Convert" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
"from": "USD",
"to": "GBP"
}'
Response
{
"from": "USD",
"to": "GBP",
"rate": 0.7104
}POSThttps://api.m3o.com/v1/currency/History
Returns the historic rates for a currency on a given date
code string
currency code e.g USD
date string
date formatted as YYYY-MM-DD
code string
The code of the request
date string
The date requested
rates object
The rate for the day as code:rate
Request
curl "https://api.m3o.com/v1/currency/History" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
"code": "USD",
"date": "2021-05-30"
}'
Response
{
"code": "USD",
"date": "2020-05-30",
"rates": {
"AED": 3.672,
"ARS": 68.3238,
"AUD": 1.5017,
"BGN": 1.7573,
"BRL": 5.372,
"BSD": 1,
"CAD": 1.3758,
"CHF": 0.9625,
"CLP": 810.6932,
"CNY": 7.1408,
"COP": 3711.2273,
"CZK": 24.2592,
"DKK": 6.7076,
"DOP": 55.3539,
"EGP": 15.8108,
"EUR": 0.9004,
"FJD": 2.2202,
"GBP": 0.8108,
"GTQ": 7.6924,
"HKD": 7.753,
"HRK": 6.8175,
"HUF": 313.7167,
"IDR": 14536.6684,
"ILS": 3.5082,
"INR": 75.5508,
"ISK": 135.7104,
"JPY": 107.4223,
"KRW": 1236.3642,
"KZT": 412.3586,
"MXN": 22.1514,
"MYR": 4.3465,
"NOK": 9.7236,
"NZD": 1.61,
"PAB": 1,
"PEN": 3.4361,
"PHP": 50.5076,
"PKR": 160.0922,
"PLN": 4.0015,
"PYG": 6803.9167,
"RON": 4.361,
"RUB": 70.561,
"SAR": 3.7548,
"SEK": 9.4421,
"SGD": 1.4125,
"THB": 31.8255,
"TRY": 6.8228,
"TWD": 30.0096,
"UAH": 26.8391,
"USD": 1,
"UYU": 43.0401,
"ZAR": 17.5029
}
}POSThttps://api.m3o.com/v1/currency/Rates
Rates returns the currency rates for a given code e.g USD
code string
The currency code to get rates for e.g USD
code string
The code requested e.g USD
rates object
The rates for the given code as key-value pairs code:rate
Request
curl "https://api.m3o.com/v1/currency/Rates" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MICRO_API_TOKEN" \
-d '{
"code": "USD"
}'
Response
{
"code": "usd",
"rates": {
"AED": 3.6725,
"AFN": 79.0514,
"ALL": 101.6054,
"AMD": 515.68,
"ANG": 1.79,
"AOA": 646.8737,
"ARS": 95.3433,
"AUD": 1.2998,
"AWG": 1.79,
"AZN": 1.7013
}
}