home / skills / dkyazzentwatwa / chatgpt-skills / currency-converter

currency-converter skill

safe

This skill converts currencies with real-time and historical rates, supports batch and CSV operations, and formats results for locale-aware usage.

npx playbooks add skill dkyazzentwatwa/chatgpt-skills --skill currency-converter

Review the files below or copy the command above to add this skill to your agents.

Files (3)

SKILL.md

772 B

---
name: currency-converter
description: Convert currencies with real-time exchange rates, historical data, and multi-currency calculations.
---

# Currency Converter

Convert between currencies with exchange rates and formatting.

## Features

- **Exchange Rates**: Convert between 150+ currencies
- **Historical Rates**: Date-based conversions
- **Batch Conversion**: Process multiple amounts
- **Currency Formatting**: Locale-specific formatting
- **CSV Support**: Convert currency columns
- **Rate Caching**: Efficient API usage

## CLI Usage

```bash
python currency_converter.py --amount 100 --from USD --to EUR
python currency_converter.py --file amounts.csv --from_col usd --to EUR --output converted.csv
```

## Dependencies

- forex-python>=1.8
- pandas>=2.0.0

Overview

This skill converts currencies using real-time exchange rates, historical data, and batch processing. It supports 150+ currencies, locale-aware formatting, and CSV import/export for bulk workflows. Designed for accuracy and efficiency with rate caching to reduce API calls.

How this skill works

The skill fetches live exchange rates from a rates provider and falls back to cached values when appropriate to limit requests. It can perform single conversions, multi-currency calculations, and date-based lookups for historical rates. CSV and batch interfaces let you convert entire columns, and formatting routines apply locale-specific currency displays.

When to use it

Convert a single amount between two currencies using current rates.
Run date-based conversions for historical reporting or accounting.
Process CSV files or spreadsheets with many amounts to convert in bulk.
Produce locale-specific formatted outputs for invoices or user displays.
Reduce API usage by serving repeated requests from cached rates.

Best practices

Cache rates for short intervals (minutes to hours) to balance freshness and API limits.
Validate CSV column types before conversion to avoid parsing errors.
Use historical-date conversions only when the exact tax or audit date matters.
Normalize currency codes to ISO 4217 (e.g., USD, EUR) before processing.
Test locale formatting with representative samples to ensure correct symbols and separators.

Example use cases

Convert a customer's checkout total from USD to EUR in real time for checkout display.
Recalculate a month-end report to local currency using exchange rates on the last business day.
Batch-convert a payroll CSV file with salaries in multiple source currencies to a single reporting currency.
Format invoices in the client’s local currency and locale for international billing.
Preprocess financial datasets by standardizing all amounts to a base currency for analysis.

FAQ

Does the skill support historical rate lookups?

Yes — you can request conversions for specific dates to get the historical rate used on that day.

Can I convert many amounts at once?

Yes — batch conversion and CSV import/export let you process large lists or spreadsheet columns efficiently.