FX overview - Corebanq

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 currency
SELL: Customer sells target currency

Rate Sources

european_bank: European Central Bank rates
currency_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.