Mallabe Currencies icon

Mallabe Currencies

Mallabe Currencies is a utility tool that allows you to convert / exchange currencies to other currencies as well as get the daily rates of currencies.

Actions2

Currency → Convert Currency

AI-generated

Overview

The "Mallabe Currencies" node provides currency conversion and exchange rate retrieval functionalities. Specifically, the Convert Currency operation allows users to convert a specified amount from one currency to another, optionally using historical exchange rates for a given date. This is useful in financial workflows, accounting automation, e-commerce pricing adjustments, or any scenario where dynamic currency conversion is required.

For example, you can convert 100 USD to EUR using the latest exchange rate or specify a past date to get the historical conversion value. Additionally, an optional webhook URL can be provided to receive conversion data asynchronously.

Properties

Name Meaning
From Currency The currency code you want to convert from. Options include all major world currencies (e.g., USD, EUR, JPY, BTC).
To Currency The currency code you want to convert to. Same options as "From Currency".
Amount The numeric amount of the "From Currency" to convert.
Date (Optional) Optional date to use historical exchange rates instead of the current rate.
Webhook URL (Optional) Optional URL to receive the conversion data via webhook callback.

Output

The node outputs a JSON array containing the conversion result(s). Each item in the output array represents the response from the currency conversion API call, which typically includes details such as:

  • The original amount and currency.
  • The target currency.
  • The converted amount based on the exchange rate.
  • The exchange rate used.
  • The date of the rate if historical data was requested.
  • Any additional metadata returned by the API.

If multiple input items are processed, the output will contain corresponding results for each.

No binary data is produced by this node.

Dependencies

  • Requires an API key credential for the Mallabe Currencies service to authenticate requests.
  • The node makes HTTP POST requests to the Mallabe Currencies API endpoints:
    • /v1/currencies/convert for currency conversion.
  • Proper network connectivity to the Mallabe API endpoint is necessary.
  • If using the webhook URL property, an accessible endpoint must be provided to receive callbacks.

Troubleshooting

  • Invalid Currency Codes: Ensure that the "From Currency" and "To Currency" values are valid ISO currency codes supported by the API.
  • API Authentication Errors: Verify that the API key credential is correctly configured and has not expired.
  • Network Issues: Check internet connectivity and firewall settings that might block access to the Mallabe API.
  • Date Format Errors: When specifying a historical date, ensure it is in a valid date format recognized by the node.
  • Webhook Failures: If using a webhook URL, confirm that the URL is reachable and properly handles incoming requests.
  • Amount Zero or Negative: The amount to convert should be a positive number; zero or negative values may cause errors.

Common error messages will relate to invalid parameters, authentication failures, or network timeouts. Reviewing the error message details and verifying input parameters usually resolves these issues.

Links and References

Discussion