ballerinax/cloudmersive.currency Ballerina library

2.0.0

Overview

The Cloudmersive Currency connector provides programmatic access to the Cloudmersive Currency API, which helps you retrieve exchange rates and convert prices between currencies. This connector supports version 1 of the API and lets Ballerina applications look up supported currencies, fetch live exchange rates and convert prices with a few remote method calls.

Key features

  • List the currencies and countries supported by the API
  • Retrieve the current exchange rate between any two supported currencies
  • Convert a price from a source currency into a destination currency
  • Authenticate with a single Cloudmersive API key

Setup guide

To use this connector you need a Cloudmersive API key.

  1. Sign up or log in at the Cloudmersive portal.
  2. Open the API Keys page of your account.
  3. Create a new API key, or copy an existing one.
  4. Supply the key as the apikey field when you initialize the client. Keep it out of source control, for example by reading it from Config.toml.

Quickstart

  1. Add the import:

    Copy
    import ballerinax/cloudmersive.currency;
  2. Create a Config.toml with your API key:

    Copy
    apiKey = "<YOUR_API_KEY>"
  3. Declare the configurable for the API key:

    Copy
    configurable string apiKey = ?;
  4. Create the client and invoke an operation:

    Copy
    public function main() returns error? {
        currency:Client currencyClient = check new ({apikey: apiKey});
        currency:ExchangeRateResult _ = check currencyClient->getExchangeRate("USD", "EUR");
    }

Examples

The Cloudmersive Currency connector provides practical examples illustrating usage in various scenarios. Explore these examples, covering the following use cases:

Import

import ballerinax/cloudmersive.currency;Copy

Other versions

See more...

Metadata

Released date: 1 day ago

Version: 2.0.0

License: Apache-2.0


Security

Direct vulnerabilities: No known direct vulnerabilities

Indirect vulnerabilities: 

Checked on 2026-11-21 via OSV.dev


Compatibility

Platform: any

Ballerina version: 2201.12.0

GraalVM compatible: Yes


Pull count

Total: 55

Current verison: 1


Weekly downloads


Source repository


Keywords

Vendor/Cloudmersive

Area/Finance & Accounting

Type/Connector


Contributors