Create a cross-rate FX quote

curl --request POST \ --url https://api.example.com/v1/fx/cross-rate-quotes \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "beneficiaryType": "individual", "fromCurrency": "NGN", "targetAmount": "100", "toCurrency": "GBP" } '

{ "crossRate": "2524.47560000", "expiresAt": "2026-04-13T12:00:30Z", "fee": "0.4000", "feeCurrency": "USD", "feeInFromCurrency": "554.8293", "fromCurrency": "NGN", "id": "uuid-here", "targetAmount": "100", "toCurrency": "GBP", "totalDebitAmount": "252447.5600" }

Authorizations

Authorization

string

header

required

Enter Auth0 JWT token

Headers

Idempotency-Key

string

Client-generated idempotency key

Body

application/json

beneficiaryType

enum<string>

required

Beneficiary type (determines amount limits)

Available options:

individual,

business

Example:

"individual"

fromCurrency

string

required

Source currency (currency debited from client)

Example:

"NGN"

targetAmount

string

required

Amount beneficiary receives (in toCurrency)

Example:

"100"

toCurrency

string

required

Target currency (currency beneficiary receives)

Example:

"GBP"

Response

crossRate

string

required

All-in rate: fromCurrency per 1 toCurrency

Example:

"2524.47560000"

expiresAt

string

required

Quote expiry timestamp (ISO 8601)

Example:

"2026-04-13T12:00:30Z"

fee

string

required

Fee amount in target currency

Example:

"0.4000"

feeCurrency

string

required

Fee currency

Example:

"USD"

feeInFromCurrency

string

required

Fee amount converted to source currency (fromCurrency)

Example:

"554.8293"

fromCurrency

string

required

Source currency

Example:

"NGN"

string

required

Quote identifier

Example:

"uuid-here"

targetAmount

string

required

Amount beneficiary receives

Example:

"100"

toCurrency

string

required

Target currency

Example:

"GBP"

totalDebitAmount

string

required

Total amount debited from client in fromCurrency

Example:

"252447.5600"

status

enum<string>

Quote status (only included on GET)

Available options:

active,

used,

expired