Lock Rate

POST

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

Lock in a trade using a previously obtained rate.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "amount": 1,
    "sourceAccountId": "jk10UfeXxZXB8y2D9gjag",
    "targetAccountId": "s-SmqN_pzdoECEQI5DVNu",
    "id": "FX-260108-095051912139",
    "reference": "jhggdjrfyut38"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "message": "string",
    "id": "string",
    "valueDate": "string",
    "sourceAmount": "string",
    "sourceCurrency": "string",
    "rate": "string",
    "targetAmount": "string",
    "targetCurrency": "string",
    "tradeReference": "string",
    "status": "processing",
    "sourceAccountNumber": "string",
    "targetAccountNumber": "string",
    "createdAt": "string",
    "updatedAt": "string"
}

🟠400Invalid input

Modified at 2026-09-10 13:34:44

Get Quote

Get Trade