Skip to main content

​
ConversionResponse

This model represents the response returned after a successful currency conversion request. You receive this model with all the conversion details including the converted amount and exchange rate.

​
Fields

​
from_currency
string
required
Source currency code used in the conversion.
​
to_currency
string
required
Target currency code used in the conversion.
​
original_amount
decimal
required
Original amount requested for conversion.
​
converted_amount
decimal
required
Converted amount in the target currency.
​
exchange_rate
decimal
required
Exchange rate used for conversion.
​
timestamp
datetime
required
When the rate was fetched.
​
source
string
required
Providers of rates.

​
Example

{
  "from_currency": "USD",
  "to_currency": "EUR",
  "amount": 100.00,
  "converted_amount": 85.50,
  "exchange_rate": 0.8550,
  "timestamp": "2025-09-27T10:30:00Z"
}

​
ExchangeRateResponse

This model represents the response returned when requesting exchange rate information between two currencies. You receive this model when querying the current exchange rate without performing a conversion.

​
Fields

​
from_currency
string
required
Source currency code.
​
to_currency
string
required
Target currency code.
​
rate
decimal
required
Exchange rate used for conversion.
​
timestamp
datetime
required
When the rate was fetched.
​
source
string
required
Providers of rates.

​
Example

{
  "from_currency": "USD",
  "to_currency": "EUR",
  "exchange_rate": 0.8550,
  "timestamp": "2025-09-27T10:30:00Z"
}

​
SupportedCurrenciesResponse

This model represents the response returned when requesting the list of supported currencies. You receive this model to discover which currency codes are available for conversion.

​
Fields

​
currencies
list[string]
required
List of currency codes supported by the API.

​
Example

{
  "currencies": ["USD", "EUR", "GBP", "JPY"]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us