Skip to main content
POST
Execute FX swap

Authorizations

Authorization
string
header
required

API Key for accessing management endpoints

Headers

Idempotency-Key
string

Idempotency key for safely retrying requests

Path Parameters

uid
string
required

User ID

aid
string
required

Account ID

Body

application/json

FX swap details

description
string
required
Minimum string length: 3
Example:

"Currency exchange EUR to USD"

ownReference
string
required
Example:

"FX-SWAP-2026-001"

fromAmount
integer
Example:

10000

quoteId
string
Example:

"q1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c"

recipient
object
toAmount
integer

Response

Created

createdAt
string
Example:

"2026-06-22T11:00:00Z"

destination
object
detailUrl
string
Example:

"/api/v1/account/fx-swaps/e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b"

displayType
string
Example:

"FX Swap"

failedAt
string
fee
object
fx
object
id
string
Example:

"e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b"

origin
object
recipient
object
reference
string
Example:

"FX-SWAP-2026-001"

sender
object
settledAt
string
state
string
Example:

"PENDING"

type
string
Example:

"FX_SWAP"

updatedAt
string
Example:

"2026-06-22T11:00:00Z"