Skip to main content
POST
Fx preview

Authorizations

ApiKey
string
header
required

The service account's API key.

Nonce
string
header
required

A GUID, single-use. A replayed nonce is rejected.

Signature
string
header
required

Base64 RSA/SHA-256 (PKCS#1 v1.5) signature over the canonical string: METHOD, path, canonical query, Timestamp, Nonce, API secret and the lowercase hex SHA-256 of the raw body, joined with LF. Sign the PUBLIC path exactly as called (e.g. /v1/webhooks), not any internal path.

Timestamp
string
header
required

Unix seconds. Rejected outside the server's tolerance window.

Body

application/json
fromCurrency
string
required
toCurrency
string
required
fromAmount
number<double> | null
toAmount
number<double> | null

Response

OK

expiryTime
string<date-time>
required
fromAmount
number<double>
required
fromCurrency
string
required
fromCurrencyPreviousBalance
number<double>
required
fxRate
number<double>
required
previewId
string<uuid>
required
toAmount
number<double>
required
toCurrency
string
required