🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Currconv

by @bytesagain-lab

Convert currencies using frankfurter.app free API. Use when converting amounts, checking exchange rates, or viewing rate history. Requires curl.

Versionv3.0.1
Downloads545
Installs2
TERMINAL
clawhub install currconv

πŸ“– About This Skill


name: CurrConv description: "Convert currencies using frankfurter.app free API. Use when converting amounts, checking exchange rates, or viewing rate history. Requires curl." version: "3.0.1" author: "BytesAgain" homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: ["currency","converter","exchange","rate","money","finance","forex","international"] categories: ["Finance", "Utility"]

CurrConv

A real currency converter using live exchange rates from the European Central Bank via the free frankfurter.app API. Convert currencies, check rates, list available currencies, and look up historical exchange rates. No API key required.

Commands

| Command | Description | |---------|-------------| | currconv convert | Convert an amount from one currency to another using live rates | | currconv rates | Show all exchange rates for a base currency (default: EUR) | | currconv list | List all available currencies with full names | | currconv history | Get a historical exchange rate with comparison to today | | currconv version | Show version | | currconv help | Show available commands and usage |

Requirements

  • Bash 4+ (set -euo pipefail)
  • curl β€” for API requests
  • python3 β€” for JSON parsing and number formatting
  • Internet connection (calls frankfurter.app API)
  • No API key required (free, public API)
  • When to Use

    1. Quick currency conversion β€” currconv convert 100 USD EUR for instant conversion 2. Checking exchange rates β€” currconv rates USD shows all rates against the dollar 3. Available currencies β€” currconv list shows all 30+ supported currencies 4. Historical rates β€” currconv history USD EUR 2024-01-15 with comparison to today's rate 5. Travel planning β€” Convert amounts between currencies before a trip

    Examples

    # Convert 100 USD to EUR
    currconv convert 100 USD EUR

    Convert 5000 JPY to GBP

    currconv convert 5000 JPY GBP

    Convert 1000 CNY to USD

    currconv convert 1000 CNY USD

    Show all rates for USD

    currconv rates USD

    Show all rates for EUR (default)

    currconv rates

    List all available currencies

    currconv list

    Get historical rate for a specific date

    currconv history USD EUR 2024-01-15

    Historical GBP to JPY rate

    currconv history GBP JPY 2023-06-01

    Example Output

    $ currconv convert 100 USD CNY
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Currency Conversion                              β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  100.00         USD                                β”‚
    β”‚  =                                                 β”‚
    β”‚  688.82         CNY                                β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Rate:  1 USD  = 6.888200   CNY                    β”‚
    β”‚  Date:  2026-03-18                                 β”‚
    β”‚  Source: European Central Bank                     β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ currconv history USD EUR 2024-01-15 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Historical Exchange Rate β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Pair: USD β†’ EUR β”‚ β”‚ Date: 2024-01-15 β”‚ β”‚ Rate: 1 USD = 0.91234 EUR β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Today: 1 USD = 0.92150 EUR β”‚ β”‚ Change: +0.009160 (+1.00%) β”‚ β”‚ Today date: 2026-03-18 β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Source: European Central Bank β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    Supported Currencies

    Run currconv list for the full list. Common currencies include:

  • USD β€” US Dollar
  • EUR β€” Euro
  • GBP β€” British Pound
  • JPY β€” Japanese Yen
  • CNY β€” Chinese Yuan
  • AUD β€” Australian Dollar
  • CAD β€” Canadian Dollar
  • CHF β€” Swiss Franc
  • KRW β€” South Korean Won
  • SGD β€” Singapore Dollar
  • 30+ currencies supported in total, all sourced from the European Central Bank.

    Data Source

    All exchange rates come from the European Central Bank via the free frankfurter.app API. Rates are typically updated once per business day. No API key or registration required.


    *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*

    Data Storage

    Rate cache stored in ~/.local/share/currconv/.

    ⚑ When to Use

    TriggerAction
    2. **Checking exchange rates** β€” `currconv rates USD` shows all rates against the dollar
    3. **Available currencies** β€” `currconv list` shows all 30+ supported currencies
    4. **Historical rates** β€” `currconv history USD EUR 2024-01-15` with comparison to today's rate
    5. **Travel planning** β€” Convert amounts between currencies before a trip

    πŸ’‘ Examples

    # Convert 100 USD to EUR
    currconv convert 100 USD EUR

    Convert 5000 JPY to GBP

    currconv convert 5000 JPY GBP

    Convert 1000 CNY to USD

    currconv convert 1000 CNY USD

    Show all rates for USD

    currconv rates USD

    Show all rates for EUR (default)

    currconv rates

    List all available currencies

    currconv list

    Get historical rate for a specific date

    currconv history USD EUR 2024-01-15

    Historical GBP to JPY rate

    currconv history GBP JPY 2023-06-01

    Example Output

    $ currconv convert 100 USD CNY
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚  Currency Conversion                              β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  100.00         USD                                β”‚
    β”‚  =                                                 β”‚
    β”‚  688.82         CNY                                β”‚
    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
    β”‚  Rate:  1 USD  = 6.888200   CNY                    β”‚
    β”‚  Date:  2026-03-18                                 β”‚
    β”‚  Source: European Central Bank                     β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

    $ currconv history USD EUR 2024-01-15 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Historical Exchange Rate β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Pair: USD β†’ EUR β”‚ β”‚ Date: 2024-01-15 β”‚ β”‚ Rate: 1 USD = 0.91234 EUR β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Today: 1 USD = 0.92150 EUR β”‚ β”‚ Change: +0.009160 (+1.00%) β”‚ β”‚ Today date: 2026-03-18 β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ Source: European Central Bank β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜