Get Quote

GET

/trade-service/api/v1/fx-rates/best-rate

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-gateway-uat.mmacs.io/platform/trade-service/api/v1/fx-rates/best-rate?sourceCurrency=NGN&targetCurrency=USD&amount=100' \
--header 'Authorization: Bearer <token>'

Responses

🟢200Get Best Rate

application/json

Body

Example

{
    "message": "The FX rate has been successfully fetched.",
    "sourceCurrency": "NGN",
    "sourceCountry": null,
    "targetCurrency": "USD",
    "targetCountry": null,
    "buyRate": "1483.45",
    "sellRate": "0.0006741042839327244",
    "validityPeriod": "60",
    "startTime": "2026-01-08T08:50:51.000Z",
    "endTime": "2026-01-08T08:51:51.000Z",
    "id": "FX-260108-095051912139",
    "createdAt": "2026-01-08T08:50:51.203Z",
    "updatedAt": "2026-01-08T08:50:51.203Z"
}

Modified at 2026-01-08 08:54:38

🔃 Conversions

Lock Rate