API URL
POST /exchange, POST /bulk-exchange
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
base
required
string
Source currency code
target
required
string
Target currency code
amount
required
number
Amount to convert
conversions
required
array
Array of conversion objects containing base, target, and amount fields
conversions[].base
required
string
Source currency code within conversion object
conversions[].target
required
string
Target currency code within conversion object
conversions[].amount
required
number
Amount to convert within conversion object
Example Request
Code
{
"base": "USD",
"target": "EUR",
"amount": 100
}Successful Response
Status
HTML
200 OKBody
Code
{
"base": "USD",
"target": "EUR",
"amount": 100,
"exchangeRate": 0.92,
"convertedAmount": "92.00",
"lastUpdated": 1712345678
}Field
Type
Description
base
string
Source currency code following ISO 4217 standard (e.g., "USD", "EUR")
target
string
Target currency code for conversion destination following ISO 4217 standard
amount
number
Original monetary value submitted for currency conversion calculation
exchangeRate
number
Real-time exchange rate applied for the currency pair conversion
convertedAmount
string
Calculated result formatted to appropriate decimal precision for the target currency
lastUpdated
integer
Unix timestamp indicating when the exchange rate data was last refreshed from market sources
conversions
array
—
Error Response
Example
Code
400 INVALID_INPUT – If required parameters are missing or malformed
400 UNSUPPORTED_CURRENCY – If a currency code is not in the supported mock listLast Updated: May 4, 2026