Skip to main content
GET
/
fx
/
quotes
Get FX quote with amount conversion
curl --request GET \
  --url https://api.example.com/fx/quotes \
  --header 'Authorization: Bearer <token>'
{
  "expiresAt": "2025-10-30T12:00:00Z",
  "fromAmount": "100.00",
  "fromCurrency": "EUR",
  "rate": "1760.01",
  "rateId": "123e4567-e89b-12d3-a456-426614174000",
  "toAmount": "176001.00",
  "toCurrency": "NGN"
}

Authorizations

​
Authorization
string
header
required

Enter Auth0 JWT token

Query Parameters

​
fromCurrency
string
required

Source currency code (ISO 4217)

Example:

"GBP"

​
toCurrency
string
required

Target currency code (ISO 4217)

Example:

"EUR"

​
clientId
string

Client/workspace ID for client-specific rates (optional, UUID format)

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
amount
number
required

Amount to convert in source currency

Required range: x >= 0
Example:

1000

Response

FX quote generated successfully with converted amount

​
expiresAt
string
required

Quote expiration timestamp

Example:

"2025-10-30T12:00:00Z"

​
fromAmount
string
required

From amount

Example:

"100.00"

​
fromCurrency
string
required

Source currency

Example:

"EUR"

​
rate
string
required

Exchange rate used

Example:

"1760.01"

​
rateId
string
required

Rate ID used for this quote

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
toAmount
string
required

To amount

Example:

"176001.00"

​
toCurrency
string
required

Target currency

Example:

"NGN"