Lock FX Exchange Rate (GQL)

post

https://api.cloud.mbanq.com/graphql (FX Trade - Lock FX Exchange Rate)

Note: All the Multi-Currency API's have the endpoint: /graphql

Secures a specific exchange rate for a limited duration to facilitate a buy or sell transaction.

Upon success, it returns an fxLockId and an expiration timestamp (fxLockExpiryAt). This ID can be provided during the execution phase to ensure the transaction uses the locked rate, protecting the user from rate fluctuations during the flow.

Body Params

Following are the details on the GraphQL fields :

Parameter	Description	Mandatory	Data Type	Example
accountId	Multi Currency Wrapper Account Id	Yes	Integer	`1`
action	Can be BUY or SELL	Yes	String	`BUY`
amount	Amount to be converted	Yes	String	`10`
currency	Target foreign currency code	Yes	String	`EUR`

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Response

200Successfully locked exchange rate.