Fixer.io Exchange Rate - Ismena website

info@ismena.com

Fixer.io Exchange Rate Connector

Connector Details

Type

Virtual machines, Single VM , BYOL

Runs on

Google Compute Engine

Last Update

24 October, 2024

Category

Overview

The Fixer.io Exchange Rate Connector facilitates seamless integration with the Fixer.io API, providing access to real-time and historical exchange rate data for 170+ world currencies. This connector acts as a proxy to streamline data retrieval, supporting actions for latest rates, currency conversions, historical rates, fluctuation data, and currency symbols.

Integration Overview

This document provides a detailed guide for each integration point, its purpose, parameters, outputs, and workflow support using the Fixer.io Exchange Rate Connector.

Supported Integration Action Points

getLatestRates: Retrieves the latest exchange rates for all supported currencies relative to a base currency.
getConversion: Retrieves the exchange rate or converts an amount between two currencies.
getTimeSeriesRates: Retrieves historical exchange rates over a specified date range.
getFluctuationData: Retrieves fluctuation data for currencies over a specified date range.
getSupportedCurrencies: Retrieves a list of supported currency codes and their names.
getHistoricalRates: Retrieves exchange rates for a specific date relative to a base currency.

Detailed Integration Documentation

Latest Rates Retrieval

Action	getLatestRates
Purpose	Retrieves a comprehensive list of the latest exchange rates for all supported currencies relative to a specified base currency. This serves as the primary entry point for accessing current exchange rate data.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. base: The base currency code (ISO 4217, string, e.g., USD). Optional: symbols: Comma-separated currency codes to limit the response (string, e.g., USD,GBP,EUR).
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). timestamp: Unix timestamp of the data (integer, e.g., 1698765432). base: Base currency code (string, e.g., USD). date: Date of the rates (string, e.g., 2025-07-23). rates: Object with currency codes and rates (e.g., USD: 1, GBP: 0.88234, EUR: 0.81057). Failure: Returns error details (e.g., invalid API key, error type: invalid_access_key).
Workflow Example	Execute the getLatestRates action with apiKey and base=USD. Process the response to display exchange rates in a financial dashboard. Use the rates for financial calculations or reporting.

Currency Conversion

Action	getConversion
Purpose	Retrieves the exchange rate between two currencies or converts a specified amount. This supports targeted currency pair data or conversions for financial applications.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. from: Source currency code (ISO 4217, string, e.g., USD). to: Target currency code (ISO 4217, string, e.g., INR). Optional: amount: Amount to convert (float, e.g., 100). date: Historical date for conversion (string, YYYY-MM-DD, e.g., 1999-08-14).
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). query: Object with from, to, amount (strings/float, e.g., USD, INR, 100). info: Object with timestamp (integer, e.g., 1698765432) and rate (float, e.g., 83.1234). date: Date of the rate (string, e.g., 2025-07-23). result: Converted amount (float, e.g., 8312.34, if amount provided). Failure: Returns error details (e.g., invalid currency code, error type: invalid_currency_code).
Workflow Example	Execute the getConversion action with apiKey, from=USD, to=INR, and optionally amount=100. Review the response to obtain the exchange rate or converted amount. Use the result for financial calculations, e-commerce, or reporting.

Time Series Rates Retrieval

Action	getTimeSeriesRates
Purpose	Retrieves historical exchange rates over a specified date range for all or a specific set of currencies. This supports longitudinal financial analysis.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. start_date: Start date of the time series (string, YYYY-MM-DD, e.g., 2012-05-01). end_date: End date of the time series (string, YYYY-MM-DD, e.g., 2012-05-25). Optional: base: Base currency code (ISO 4217, string, e.g., USD). symbols: Comma-separated currency codes to limit the response (string, e.g., USD,EUR).
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). timeseries: Time series indicator (boolean, e.g., true). start_date: Start date (string, e.g., 2012-05-01). end_date: End date (string, e.g., 2012-05-25). base: Base currency code (string, e.g., USD). rates: Object with daily rates (e.g., {"2012-05-01": {"USD": 1.3221, "EUR": 0.7556}}). Failure: Returns error details (e.g., invalid date range, error type: invalid_date_range).
Workflow Example	Execute the getTimeSeriesRates action with apiKey, start_date=2012-05-01, and end_date=2012-05-25. Analyze the time series data for trends or forecasting. Store the data for further analysis or visualization.

Fluctuation Data Retrieval

Action	getFluctuationData
Purpose	Retrieves fluctuation data for currencies over a specified date range, including start/end rates and percentage changes. This supports financial volatility analysis.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. start_date: Start date of the fluctuation period (string, YYYY-MM-DD, e.g., 2015-12-01). end_date: End date of the fluctuation period (string, YYYY-MM-DD, e.g., 2016-05-24). Optional: base: Base currency code (ISO 4217, string, e.g., USD). symbols: Comma-separated currency codes to limit the response (string, e.g., USD).
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). fluctuation: Fluctuation indicator (boolean, e.g., true). start_date: Start date (string, e.g., 2015-12-01). end_date: End date (string, e.g., 2016-05-24). base: Base currency code (string, e.g., USD). rates: Object with fluctuation data (e.g., USD: {start_rate: 1.23396, end_rate: 1.23400, change: 0.00004, change_pct: 0.0032}). Failure: Returns error details (e.g., invalid date range, error type: invalid_date_range).
Workflow Example	Execute the getFluctuationData action with apiKey, start_date=2015-12-01, and end_date=2016-05-24. Analyze fluctuation data for risk assessment or investment planning. Store the data for reporting or visualization.

Historical Rates Retrieval

Action	getHistoricalRates
Purpose	Retrieves exchange rates for a specific date relative to a base currency. This enables historical data analysis for research or reporting.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. date: Historical date (string, YYYY-MM-DD, e.g., 2013-12-24). base: Base currency code (ISO 4217, string, e.g., USD). Optional: symbols: Comma-separated currency codes to limit the response (string, e.g., INR).
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). timestamp: Unix timestamp of the data (integer, e.g., 1387929599). base: Base currency code (string, e.g., USD). date: Historical date (string, e.g., 2013-12-24). rates: Object with currency codes and rates (e.g., INR: 83.1234). Failure: Returns error details (e.g., no data available, error type: no_data_available).
Workflow Example	Execute the getHistoricalRates action with apiKey, date=2013-12-24, and base=USD. Review historical rates for trend analysis or academic research. Store the rates for further processing.

Supported Currencies Retrieval

Action	getSupportedCurrencies
Purpose	Retrieves a list of supported currency codes and their names. This helps users validate currency codes or build currency selection interfaces.
Parameters	Required: apiKey: Your Fixer.io API key (string, e.g., YOUR-API-KEY). Register at fixer.io to obtain an API key. Optional: None.
Output	Successful: Returns a JSON object with: success: Success status (boolean, e.g., true). symbols: Object with currency codes and names (e.g., USD: United States Dollar, EUR: Euro, INR: Indian Rupee). Failure: Returns error details (e.g., invalid request, error type: invalid_request).
Workflow Example	Execute the getSupportedCurrencies action with apiKey. Review the response to select currency codes (e.g., USD, EUR, INR). Use the codes to populate a currency selection dropdown.

Workflow Creation with the Connector

Example Workflow: Currency Conversion and Historical Analysis

Retrieve Supported Currencies	Execute the getSupportedCurrencies action with apiKey to fetch a list of available currency codes. Identify target currencies (e.g., USD, EUR, INR) for subsequent actions.
Query Latest Rates	Execute the getLatestRates action with apiKey and base=USD to fetch current exchange rates. Process the response to display rates in a financial dashboard or use for calculations.
Perform Currency Conversion	Execute the getConversion action with apiKey, from=USD, to=INR, and amount=100 to convert an amount. Save the converted amount for e-commerce, financial reporting, or user display.
Explore Historical Rates	Execute the getHistoricalRates action with apiKey, date=2013-12-24, and base=USD to fetch rates for a specific date. Review the rates for historical analysis or research.
Analyze Time Series Data	Execute the getTimeSeriesRates action with apiKey, start_date=2012-05-01, and end_date=2012-05-25 to fetch rates over a date range. Analyze the data for trends, forecasting, or financial modeling.
Assess Currency Fluctuations	Execute the getFluctuationData action with apiKey, start_date=2015-12-01, and end_date=2016-05-24. Use the fluctuation data for risk assessment, investment planning, or volatility analysis.

Pricing

bill-and-calculator-2023-11-27-05-25-06-utc 1

Request a Quote

Support

For Technical support please contact us on

custom-connectors-support@isolutions.sa

A tech solution company dedicated to providing innovation thus empowering businesses to thrive in the digital age.

Register to IBM x iSolution Event