FX Trade - Execute FX Buy/Sell

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

Functional Flow:

  • Buy Currency: The base currency sub-account is debited (including any applicable fees), and the target foreign currency sub-account is credited.
  • Sell Currency: The foreign currency sub-account is debited, and the base currency sub-account is credited.

Business Rules:

  • Charges are applied exclusively to BUY operations and are debited from the base currency sub-account.
  • Transaction sub-types are recorded as "Buy/Sell Currency" for clear ledger identification.
  • If a rate was previously locked, the fxLockId should be provided in the request body to ensure the transaction uses the agreed rate.
  • All conversions and fees are processed through the base currency sub-account.
Path Params
integer
required

Multi Currency Wrapper Account Id.

Query Params
string
required

Command to execute.

Body Params
string
enum
required
Allowed:
number
required
string
required
string

Optional reference for the trade. reference text length must be less than or equal to 255 characters

integer

The lock ID obtained from the lock API.

Headers
string
required

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

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json