Get a quote using the best live rate available right now.
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
sourceCurrency
string
required
The source/sell currency (ISO3 Code)
Example:
NGN
destinationCurrency
string
required
The destination/target/buy currency (ISO3 Code)
Example:
USD
amount
number
required
The destination/target/buy amount
Example:
100
Request 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 GET 'https://api-gateway-uat.mmacs.io/platform/trade-service/api/v1/fx-rates/best-rate?sourceCurrency=NGN&destinationCurrency=USD&amount=100'
Responses
🟢200Get Best Rate
application/json
Body
message
string
required
sourceCurrencyIso3Code
string
required
sourceCountryIso3Code
string
required
targetCurrencyIso3Code
string
required
buyRate
string
required
sellRate
string
required
validityPeriod
string
required
startTime
string
required
endTime
string
required
code
string
required
createdAt
string
required
updatedAt
string
required
Example
{"message":"The FX rate has been successfully fetched.","sourceCurrencyIso3Code":"NGN","sourceCountryIso3Code":"NGA","targetCurrencyIso3Code":"USD","buyRate":"1636.342512669382","sellRate":"0.000611119","validityPeriod":"30","startTime":"2025-01-10T18:24:29.000Z","endTime":"2025-01-10T18:24:59.000Z","code":"fxr_PvSNZn2vFxqqF3","createdAt":"2025-01-10T18:24:29.539Z","updatedAt":"2025-01-10T18:24:29.539Z"}
