Custom Connector
Frankfurter Connector
Global
The Frankfurter Connector provides a RESTful interface to real-time and historical foreign-exchange rate data sourced from the European Central Bank (ECB). It lets applications retrieve the latest rates, query historical data by date or range, and list supported currencies — ideal for currency converters, dashboards, and analytical tools.
Overview
Integration Overview
The Frankfurter Connector offers the following integration points for retrieving currency exchange data.
- Get Latest Rates. Retrieve current exchange rates for all or selected currencies.
- Get Rates by Date. Retrieve exchange rates for a specific historical date.
- Get Rates by Date Range. Retrieve historical exchange rates for a specified period.
- Get Supported Currencies. List all available currency codes and descriptions.
Documentation
Detailed Integration Documentation
Get Latest Rates
| Operation ID | getLatestRates |
|---|---|
| Endpoint | GET /latest |
| Parameters | Optional: base — base currency code (default EUR); symbols — comma-separated target currency codes. |
| Purpose | Retrieves the most recent available exchange rates. |
| Output | JSON object with base currency, date, and rates. |
| Workflow example | Use to update currency-conversion widgets or show the latest market rates. |
Get Rates by Date
| Operation ID | getRatesByDate |
|---|---|
| Endpoint | GET /{date} |
| Parameters | Required: date (path, YYYY-MM-DD) — historical date. Optional: base (default EUR); symbols. |
| Purpose | Retrieves official ECB exchange rates for a specific date. |
| Output | JSON object with rates for the given day. |
| Workflow example | Populate historical-data charts or show past conversion values. |
Get Rates by Date Range
| Operation ID | getRatesByDateRange |
|---|---|
| Endpoint | GET /{start}..{end} |
| Parameters | Required: start, end (path, YYYY-MM-DD). Optional: base (default EUR); symbols. |
| Purpose | Returns exchange rates over a defined period. |
| Output | JSON object with rates keyed by date. |
| Workflow example | Generate trend lines, analyze currency performance, or backtest strategies. |
Get Supported Currencies
| Operation ID | getSupportedCurrencies |
|---|---|
| Endpoint | GET /currencies |
| Parameters | Required: None. |
| Purpose | Lists all currency codes and their full names supported by the API. |
| Output | JSON object mapping currency codes to descriptions. |
| Workflow example | Dynamically build currency-selection dropdowns. |
Example Workflow: Currency Conversion Dashboard
| Get supported currencies | Call getSupportedCurrencies to populate currency dropdown menus. |
|---|---|
| Fetch latest rates | Use getLatestRates to show today’s rates for the selected base currency. |
| View historical data | Use getRatesByDate or getRatesByDateRange for past values and trends. |
| Update in real time | Schedule periodic calls to /latest to refresh rates. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.