info@ismena.com
Ismena websiteIsmena websiteIsmena websiteIsmena website
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us

Technologies

Integration

Custom Connectors

Explore All Connectors

CurrencyLayer Connector

CurrencyLayer Connector

Connector Details

Type

Virtual machines, Single VM , BYOL

Runs on

Google Compute Engine

Last Update

24 October, 2024

Category

Overview

Documentation

Pricing

Support

Overview

The CurrencyLayer Connector enables seamless access to real-time and historical foreign exchange rate data for a wide range of global currencies. The connector is designed to support common financial and analytical use cases such as retrieving the full list of supported currencies, monitoring live exchange rates, converting currency amounts, and analyzing trends over time through historical and timeframe-based data. It also supports fluctuation monitoring, allowing users to track percentage and absolute changes in currency values over a defined period.

Integration Overview

This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the CurrencyLayer Connector.

  • getCurrencyList: Retrieves a list of supported currencies and codes.
  • getLiveRates: Retrieves the latest real-time exchange rates.
  • getHistoricalRates: Retrieves exchange rates for a specific date.
  • convertCurrency: Converts a specified amount between two currencies.
  • getTimeframeRates: Retrieves exchange rates over a defined date range.
  • getChangeRates: Retrieves fluctuations of currencies over a time period.

Detailed Integration Documentation

Currency List Retrieval

Action getCurrencyList
Purpose Retrieves all available currencies and their symbols supported by CurrencyLayer.
Parameters
  • Required: access_key: Your API key (string, e.g., YOUR-API-KEY).
Output
  • Successful: Returns a JSON object with currency codes and names.
  • Failure: Returns error details (e.g., invalid API key).
Workflow Example
  • Configure the connector with CONNECTOR_ENV_CURRENCY_API_BASE_URL.
  • Execute the getCurrencyList action with access_key.
  • Use the result to populate dropdowns or validate inputs.

Live Rates Retrieval

Action getLiveRates
Purpose Retrieves the most recent real-time exchange rates relative to a base currency.
Parameters
  • Required: access_key: Your API key.
  • Optional: source: Base currency (default: USD).
  • Optional: currencies: Comma-separated target currencies (e.g., EUR,GBP).
Output
  • Successful: Returns base currency, timestamp, and conversion rates.
  • Failure: Returns error details (e.g., unsupported code).
Workflow Example
  • Execute /live?access_key=YOUR-API-KEY&source=USD¤cies=EUR,GBP.
  • Process rates to display in dashboards or apps.

Historical Rates Retrieval

Action getHistoricalRates
Purpose Retrieves historical exchange rates for a specific date.
Parameters
  • Required: access_key: Your API key.
  • Required: date: Date of the request (YYYY-MM-DD).
  • Optional: source: Base currency (default: USD).
  • Optional: currencies: Target currencies.
Output
  • Successful: Returns historical rates for the given date.
  • Failure: Returns error details (e.g., no data available).
Workflow Example
  • Execute /historical?access_key=YOUR-API-KEY&date=2020-01-01&source=USD¤cies=EUR.
  • Use results for financial or research analysis.

Currency Conversion

Action convertCurrency
Purpose Converts a specified amount between two currencies using real-time or historical rates.
Parameters
  • Required: access_key: Your API key.
  • Required: from: Source currency code (e.g., USD).
  • Required: to: Target currency code (e.g., EUR).
  • Required: amount: Amount to convert.
  • Optional: date: Convert using historical data.
Output
  • Successful: Returns converted amount with rate used.
  • Failure: Returns error details (e.g., invalid request).
Workflow Example
  • Execute /convert?access_key=YOUR-API-KEY&from=USD&to=EUR&amount=100.
  • Use response for e-commerce, reporting, or analytics.

Timeframe Rates Retrieval

Action getTimeframeRates
Purpose Retrieves exchange rates over a defined start and end date.
Parameters
  • Required: access_key: Your API key.
  • Required: start_date: Start date (YYYY-MM-DD).
  • Required: end_date: End date (YYYY-MM-DD).
  • Optional: source: Base currency (default: USD).
  • Optional: currencies: Target currencies.
Output
  • Successful: Returns rate data across the specified timeframe.
  • Failure: Returns error details (e.g., invalid date).
Workflow Example
  • Execute /timeframe?access_key=YOUR-API-KEY&start_date=2020-01-01&end_date=2020-01-05¤cies=EUR.
  • Use data for time-series trend analysis.

Change Rates Retrieval

Action getChangeRates
Purpose Retrieves exchange rate fluctuations for specified currencies within a time period.
Parameters
  • Required: access_key: Your API key.
  • Optional: currencies: Comma-separated target currencies.
  • Optional: start_date: Start date (YYYY-MM-DD).
  • Optional: end_date: End date (YYYY-MM-DD).
Output
  • Successful: Returns percentage and absolute changes for selected currencies.
  • Failure: Returns error details (e.g., missing parameters).
Workflow Example
  • Execute /change?access_key=YOUR-API-KEY¤cies=EUR,GBP&start_date=2020-01-01&end_date=2020-01-10.
  • Use fluctuations to assess risks or portfolio performance.

Workflow Creation with the Connector

Example Workflow: Currency Monitoring and Conversion

Step 1 Retrieve Supported Currencies: Use getCurrencyList to fetch available codes.
Step 2 Fetch Live Rates: Use getLiveRates to monitor market movements.
Step 3 Convert Amounts: Use convertCurrency for transactions.
Step 4 Analyze Historical Data: Use getHistoricalRates for past insights.
Step 5 Trend Analysis: Use getTimeframeRates for time-series review.
Step 6 Track Fluctuations: Use getChangeRates for volatility analysis.

Pricing

Request a Quote

Support

For Technical support please contact us on

custom-connectors-support@isolutions.sa

iSolution logo - white - transparent 250 px

iSolution logo - white - transparent 250 px

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

  • Home
  • About us
  • Blog
  • Careers
  • Success Stories
  • News
  • Articles
  • Contact Us
  • Terms and conditions
  • Privacy Policy
© Copyright 2024 iSolution | All Rights Reserved
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us
Ismena website

Register To Palo Alto & iSolution Event

Register to IBM x iSolution Event

Register to Gemini in Action Workshop

[forminator_form id=”14485″]

Registration To Amman Unplugged Event

[forminator_form id=”14419″]

Register to Gemini in Action Workshop

[forminator_form id=”14298″]

Tech and Culture Riyadh

[forminator_form id=”13094″]