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": "FX-260108-095051912139",
    "sourceAccountId": "jk10UfeXxZXB8y2D9gjag",   
    "targetAccountId": "s-SmqN_pzdoECEQI5DVNu", 
    "reference": "jhggdjrfyut38",
    "amount": 1
}

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 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "FX-260108-095051912139",
    "sourceAccountId": "jk10UfeXxZXB8y2D9gjag",   
    "targetAccountId": "s-SmqN_pzdoECEQI5DVNu", 
    "reference": "jhggdjrfyut38",
    "amount": 1
}'

Responses

🟢200OK

application/json

Body

Example

{
    "message": "The FX rate has been successfully locked.",
    "id": "FX-260108-100556782690",
    "valueDate": "2026-01-08T09:05:57.203Z",
    "sourceAmount": "1663.82",
    "sourceCurrency": "NGN",
    "rate": "0.0006010254429251893",
    "targetAmount": "1",
    "targetCurrency": "USD",
    "tradeReference": "lateef Test FX Lock Rate - Ritchieton",
    "status": "completed",
    "sourceAccountNumber": "9547511784",
    "targetAccountNumber": "1318473923",
    "createdAt": "2026-01-08T09:05:57.203Z",
    "updatedAt": "2026-01-08T09:05:57.385Z"
}

🟠400Invalid input

Modified at 2026-01-08 09:09:57

Get Quote

Get Trade