Skip to main content
POST
/
v1
/
fx
/
cross-rate-quotes
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.zuba.com/llms.txt

Use this file to discover all available pages before exploring further.

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"

​
id
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