v47

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-013871777.1 KB

Execute FX

Execute a standalone foreign exchange transaction.

post/api/service/fx/execute

Idempotency-Keystring

Idempotency key for safe retries. Takes precedence over the deprecated body field.

idempotencyKeystring

Deprecated: use the Idempotency-Key request header instead.

sourceAmountstring required

The amount of source currency to convert. Minimum: 10

sourceAccountIdstring uuid required

The source account id.

targetAccountIdstring uuid required

The target account id.

metadataobject

Additional metadata.

FX executed successfully

idstring required

The fxId attached to the transfer.

ratestring required

The exchange rate for the given currency pair.

targetAmountstring

The amount of the target currency for the given source amount.

sourceAmountstring

The amount of source currency to convert.

sourceCurrency'EUR' | 'GBP' | 'USDC' required

The source currency code

targetCurrency'EUR' | 'GBP' | 'USDC' required

The target currency code

metadataobject

Additional metadata.

status'initiated' | 'succeeded' | 'failed' required

The status of the FX transaction.