Overview
The FX API provides functionality for managing:- Exchange rate operations
- FX tariffs and fee structures
- Currency conversion
- Rate source management
Core Concepts
Exchange Rate Types
BUY: Customer buys target currencySELL: Customer sells target currency
Rate Sources
european_bank: European Central Bank ratescurrency_cloud: Currency Cloud provider rates
Fee Calculation Methods
| Method | Description | Formula |
|---|---|---|
fixed | Fixed fee amount | fee = fixed_fee |
percentage | Percentage of amount | fee = amount * (percent_fee/100) |
greater | Greater of fixed/percent | fee = max(fixed_fee, percent_fee) |
lesser | Lesser of fixed/percent | fee = min(fixed_fee, percent_fee) |
sum | Sum of fixed and percent | fee = fixed_fee + percent_fee |
Validation Rules
Amount Constraints
- Must be positive number
- Within min/max limits
- Proper decimal places
Fee Rules
- Valid date range required
- Non-overlapping ranges
- Valid calculation method
Security Requirements
- Rate updates require elevated access
- Tariff management restricted
- Changes are audited
- Source must be authorized
See individual endpoint documentation for detailed request/response formats and examples.