Currconv
by @bytesagain-lab
Convert currencies using frankfurter.app free API. Use when converting amounts, checking exchange rates, or viewing rate history. Requires curl.
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
set -euo pipefail)curl β for API requestspython3 β for JSON parsing and number formattingWhen 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 EURConvert 5000 JPY to GBP
currconv convert 5000 JPY GBPConvert 1000 CNY to USD
currconv convert 1000 CNY USDShow all rates for USD
currconv rates USDShow all rates for EUR (default)
currconv ratesList all available currencies
currconv listGet historical rate for a specific date
currconv history USD EUR 2024-01-15Historical 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:
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
π‘ Examples
# Convert 100 USD to EUR
currconv convert 100 USD EURConvert 5000 JPY to GBP
currconv convert 5000 JPY GBPConvert 1000 CNY to USD
currconv convert 1000 CNY USDShow all rates for USD
currconv rates USDShow all rates for EUR (default)
currconv ratesList all available currencies
currconv listGet historical rate for a specific date
currconv history USD EUR 2024-01-15Historical 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 β
βββββββββββββββββββββββββββββββββββββββββββββββββββββ