Skip to main content
GET
/
fx
/
rates
/
current
Get current rate for a currency pair
curl --request GET \
  --url https://api.example.com/fx/rates/current \
  --header 'Authorization: Bearer <token>'
{
  "createdAt": "2025-10-29T12:00:00Z",
  "expiresAt": "2025-10-30T12:00:00Z",
  "fromCurrency": "EUR",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "rate": "1760.01",
  "toCurrency": "NGN"
}

Authorizations

​
Authorization
string
header
required

Enter Auth0 JWT token

Query Parameters

​
fromCurrency
string
required

Source currency code (ISO 4217)

Example:

"EUR"

​
toCurrency
string
required

Target currency code (ISO 4217)

Example:

"USD"

​
clientId
string

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

Example:

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

​
amount
string

Amount to convert

Example:

"100.00"

Response

Current FX rate retrieved successfully

​
createdAt
string
required

Creation timestamp

Example:

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

​
expiresAt
string
required

Rate expiration timestamp

Example:

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

​
fromCurrency
string
required

Source currency (ISO 4217)

Example:

"EUR"

​
id
string
required

Rate ID

Example:

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

​
rate
string
required

Exchange rate (final rate including any markup)

Example:

"1760.01"

​
toCurrency
string
required

Target currency (ISO 4217)

Example:

"NGN"