Execute FX Buy/Sell (GQL)

post

https://api.cloud.mbanq.com/graphql (FX Trade - Execute FX Buy/Sell)

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

Executes the currency exchange (Buy or Sell) between the account's base currency and a supported foreign currency.

Business Rules:

Buy Currency: The base currency sub-account is debited (including fees), and the target foreign sub-account is credited.
Sell Currency: The foreign sub-account is debited, and the base currency sub-account is credited.
Charges are applied exclusively to BUY operations.
If a rate was previously locked, provide the fxLockId to ensure the locked rate is used.

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`
reference	Optional reference text	No	String	`buy currency`
fxLockId	Optional lock ID from lockFxRate	No	Integer	`1`

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

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

Responses

400

Invalid request.

404

Resource not found.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully executed trade.