💱 Exchange Rate & Currency Converter

Fetch live and historical foreign exchange rates for 160+ world currencies. Convert amounts, build time-series charts, and compare rates across base currencies — all powered by central bank data from the ECB, Federal Reserve, BOJ, and 30+ official sources.

Free. No API key. No login needed.

---

What does this actor do?

This actor fetches exchange rate data from two free, open APIs — Frankfurter and Open Exchange Rates. Both source data from central banks and are completely free with no authentication required.

Use it to:

• Get real-time exchange rates for any currency pair
• Convert amounts between currencies (e.g., 1000 USD → EUR, GBP, JPY)
• Fetch historical rates for any date back to January 1999
• Build time-series data for currency trend analysis
• Compare how different base currencies perform against targets
• Power pricing engines, dashboards, and financial apps

---

Scrape modes

Mode	What it does	Required input
Latest Rates	Current exchange rates for a base currency	base_currency
Historical Rates	Rates on a specific past date	base_currency, date
Time Series	Rates over a date range (daily/weekly/monthly)	base_currency, date_from
Convert Amount	Convert a specific amount to target currencies	base_currency, amount, target_currencies
Multi-Base Comparison	Latest rates from multiple base currencies side-by-side	multi_bases
List Currencies	All 160+ available currency codes and names	None

---

Input examples

Example 1: Get latest USD rates for major currencies

{
    "scrape_mode": "latest",
    "base_currency": "USD",
    "target_currencies": "EUR, GBP, JPY, CNY, INR, PKR, CAD, AUD, CHF, BRL"
}

Example 2: Historical rates on a specific date

{
    "scrape_mode": "historical",
    "base_currency": "EUR",
    "target_currencies": "USD, GBP, JPY",
    "date": "2024-01-15"
}

Example 3: Monthly EUR/USD time series for 2024

{
    "scrape_mode": "time_series",
    "base_currency": "EUR",
    "target_currencies": "USD",
    "date_from": "2024-01-01",
    "date_to": "2024-12-31",
    "group_by": "month"
}

Example 4: Convert 5000 USD to multiple currencies

{
    "scrape_mode": "convert",
    "base_currency": "USD",
    "target_currencies": "EUR, GBP, JPY, INR, PKR, AED",
    "amount": 5000
}

Example 5: Compare USD vs EUR vs GBP as base currencies

{
    "scrape_mode": "multi_base",
    "multi_bases": "USD, EUR, GBP, JPY, CNY",
    "target_currencies": "CAD, AUD, CHF, INR, PKR"
}

Example 6: List all available currencies

{
    "scrape_mode": "currencies"
}

---

Output format

Latest / Historical rate record

{
    "type": "exchange_rate",
    "base": "USD",
    "target": "EUR",
    "rate": 0.9215,
    "rate_open_er": 0.9218,
    "inverse_rate": 1.085187,
    "date": "2026-04-04",
    "scraped_at": "2026-04-05T12:00:00+00:00"
}

Conversion record

{
    "type": "conversion",
    "from_currency": "USD",
    "to_currency": "EUR",
    "amount": 5000,
    "rate": 0.9215,
    "converted_amount": 4607.5,
    "formatted": "5,000.00 USD = 4,607.50 EUR",
    "date": "2026-04-04"
}

Time series record

{
    "type": "time_series_rate",
    "base": "EUR",
    "target": "USD",
    "rate": 1.0856,
    "date": "2024-01-01",
    "period": "2024-01-01 to 2024-12-31",
    "group_by": "month",
    "total_data_points": 12
}

Multi-base comparison record

{
    "type": "multi_base_rate",
    "base": "USD",
    "date": "2026-04-04",
    "CAD": 1.3542,
    "AUD": 1.5231,
    "CHF": 0.8876,
    "INR": 83.42,
    "PKR": 278.50
}

Currency list record

{
    "type": "currency",
    "code": "USD",
    "name": "United States Dollar",
    "total_currencies": 160
}

---

Popular currency codes

Code	Currency		Code	Currency
USD	US Dollar		INR	Indian Rupee
EUR	Euro		PKR	Pakistani Rupee
GBP	British Pound		BRL	Brazilian Real
JPY	Japanese Yen		MXN	Mexican Peso
CNY	Chinese Yuan		KRW	South Korean Won
CAD	Canadian Dollar		TRY	Turkish Lira
AUD	Australian Dollar		ZAR	South African Rand
CHF	Swiss Franc		AED	UAE Dirham
SGD	Singapore Dollar		SAR	Saudi Riyal
HKD	Hong Kong Dollar		BTC	Bitcoin (Open ER)

Use List Currencies mode to see all 160+ supported codes.

---

Data sources

This actor uses two complementary APIs for maximum reliability:

API	Source	Currencies	Historical	Key Required
Frankfurter	30+ central banks (ECB, Fed, BOJ…)	160+	From 1999	No
Open ER API	Central banks + commercial sources	160+	Limited	No

Frankfurter is the primary source. Open ER API is used as a fallback and for cross-validation on latest rates.

---

Time series grouping

When fetching time series data, use group_by to downsample:

Group	Returns	Best for
daily	Every business day	Short ranges (1-3 months)
week	Weekly averages	Medium ranges (3-12 months)
month	Monthly averages	Long ranges (1-5 years)
quarter	Quarterly averages	Multi-year analysis
year	Yearly averages	Decade-scale trends

Tip: For large date ranges, use month or quarter to keep response sizes manageable.

---

Cost and performance

Mode	Records	Time	Credits
Latest (10 currencies)	10	~3 sec	< $0.01
Latest (all currencies)	160	~3 sec	< $0.01
Historical (1 date)	10	~3 sec	< $0.01
Time series (1 year, monthly)	12	~5 sec	< $0.01
Convert (10 targets)	10	~3 sec	< $0.01
Multi-base (5 bases)	5	~8 sec	< $0.01

---

Scheduling ideas

Daily rate tracker

Schedule a daily run to build a rate history database:

{
    "scrape_mode": "latest",
    "base_currency": "USD",
    "target_currencies": "EUR, GBP, JPY, CNY, INR, PKR"
}

→ Connect to Google Sheets for an auto-updating exchange rate dashboard.

Weekly currency report

{
    "scrape_mode": "time_series",
    "base_currency": "USD",
    "target_currencies": "EUR, GBP",
    "date_from": "auto_last_7_days",
    "group_by": "daily"
}

---

Tips

• Leave target_currencies empty to get rates for all 160+ currencies at once.
• Use inverse_rate to quickly see how much 1 unit of the target buys in the base currency.
• Cross-validate — latest rates include both Frankfurter and Open ER values for comparison.
• Historical data goes back to January 4, 1999 (start of ECB data).
• Weekend dates return the most recent Friday's rates (forex markets are closed on weekends).
• Crypto rates (BTC, ETH) are available through Open ER API but not Frankfurter.
• The APIs are free but please don't schedule runs more often than every 15 minutes.

---

Limitations

• Exchange rates are indicative midpoint rates, not live trading rates.
• Not suitable for forex trading or cross-currency settlement processing.
• No buy/sell spread data — only midpoint rates.
• Historical data starts from 1999-01-04 (ECB inception date).
• Weekend and holiday dates return the most recent business day's rates.
• Cryptocurrency support is limited to the Open ER API fallback.
• Rates update daily (Frankfurter) or hourly (Open ER).

---

Changelog

v1.0.0 (2026-04-05)

• Initial release
• 6 scrape modes: latest, historical, time series, convert, multi-base comparison, currency list
• Dual API sourcing (Frankfurter + Open ER) with automatic fallback
• Cross-validation on latest rates
• Time series grouping (daily/weekly/monthly/quarterly/yearly)
• Inverse rate calculation
• Formatted conversion strings
• 160+ currencies supported