Lock Rate

POST

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

Lock in a trade using a previously obtained rate.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "id": "fxr_7m2ScBy6TZI6Qh",
    "sourceAccountId": "AZ99gZadFmmw5Z5W5FDXy",
    "targetAccountId": "jKp7XzQ3WvMl2Rt8Y9GnB",
    "amount": 100
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-gateway-uat.mmacs.io/platform/trade-service/api/v1/fx-rates/lock-rate' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "fxr_7m2ScBy6TZI6Qh",
    "sourceAccountId": "AZ99gZadFmmw5Z5W5FDXy",
    "targetAccountId": "jKp7XzQ3WvMl2Rt8Y9GnB",
    "amount": 100
}'

Responses

🟢200OK

application/json

Body

Example

{
    "message": "The FX rate has been successfully locked.",
    "id": "fxr_lck_Bpp4QwX77UfMhE",
    "valueDate": "2025-04-03T22:29:11.679Z",
    "sourceAmount": "163634.25",
    "sourceCurrency": "NGN",
    "rate": "0.0006111189998765252",
    "targetAmount": "100",
    "targetCurrency": "USD",
    "tradeReference": "fxr_5bDRH6DeaUyYNU",
    "status": "processing",
    "sourceAccountNumber": "0018251053",
    "targetAccountNumber": "0378576798",
    "createdAt": "2025-04-03T22:29:11.679Z",
    "updatedAt": "2025-04-03T22:29:11.679Z"
}

🟠400Invalid input

Modified at 2025-04-16 16:34:25

Get Quote

Get Trade