Create Conversion Quote

post

http://localhost:8080/v1/fx/quotes

Get a detailed FX quote for converting between the account's currency and another currency. To use this endpoint please contact your CSM, this functionality requires agreement to be used.

Body Params

Request for FX conversion quote

amount

number

required

Amount to convert in fixed side currency

buyCurrency

string

enum

required

Currency to buy (ISO 3-letter code)

fixedSide

string

enum

required

The side of the trade to be fixed in value. Possible values:

BUY: The buy side is fixed, sell amount variable
SELL: The sell side is fixed, buy amount variable

Allowed:

idempotencyKey

uuid

required

Unique value (UUID) used to identify this request and used to recognise any subsequent retries

marginPercentage

number | null

Optional margin percentage override (e.g. 1.5 for 1.5%). When absent, the configured default margin is applied.

sellAccountId

uuid

required

The account ID to sell from (will be debited)

Responses

200Success

400Bad Request

403Forbidden

422Unprocessable Content

500Internal Server Error

501Not Implemented