Currency Exchange Rates Actor

This Apify Actor fetches real-time and historical currency exchange rates for 200+ currencies including cryptocurrencies.

🌟 Features

• 💱 200+ currencies - Fiat currencies, cryptocurrencies (BTC, ETH, etc.), and metals
• 📅 Historical rates - Get rates for any past date
• 🔄 Flexible conversions - Single conversion or all rates at once
• 💰 Amount calculation - Convert any amount automatically
• 🚀 Blazing fast - CDN-delivered with automatic fallback
• 🆓 Free & unlimited - No API keys or rate limits
• ⚡ Auto-fallback - Built-in fallback mechanism for 99.9% uptime

📥 Input

The actor accepts the following input parameters:

{
  "from": "usd",
  "to": "eur",
  "amount": 100,
  "date": "latest",
  "listCurrencies": false
}

Input Parameters

Parameter	Type	Default	Description
from	string	"usd"	Source currency code (e.g., usd, eur, btc, eth) - case-insensitive
to	string	null	Target currency code (optional - leave empty for all rates)
amount	number	1	Amount to convert
date	string	"latest"	Date in YYYY-MM-DD format or "latest" for current rates
listCurrencies	boolean	false	Get list of all 200+ supported currencies

📤 Output

Example 1: Single Conversion

Input:

{
  "from": "usd",
  "to": "eur",
  "amount": 100,
  "date": "latest"
}

Output:

{
  "type": "single_conversion",
  "from": "USD",
  "to": "EUR",
  "date": "2024-03-06",
  "rate": 0.923456,
  "amount": 100,
  "convertedAmount": 92.3456,
  "message": "100 USD = 92.3456 EUR"
}

Example 2: All Rates for Base Currency

Input:

{
  "from": "btc",
  "amount": 1,
  "date": "latest"
}

Output:

{
  "type": "all_rates",
  "baseCurrency": "BTC",
  "date": "2024-03-06",
  "rates": {
    "usd": 65432.10,
    "eur": 60123.45,
    "gbp": 51234.56,
    "eth": 23.456,
    "...": "..."
  },
  "amount": 1,
  "convertedAmounts": {
    "USD": 65432.10,
    "EUR": 60123.45,
    "GBP": 51234.56,
    "ETH": 23.456,
    "...": "..."
  }
}

Example 3: List All Currencies

Input:

{
  "listCurrencies": true
}

Output:

{
  "type": "currency_list",
  "totalCurrencies": 200,
  "currencies": {
    "usd": "United States Dollar",
    "eur": "Euro",
    "btc": "Bitcoin",
    "eth": "Ethereum",
    "gbp": "British Pound Sterling",
    "...": "..."
  }
}

💡 Usage Examples

Convert USD to EUR

{
  "from": "usd",
  "to": "eur",
  "amount": 100
}

Get Bitcoin price in all currencies

{
  "from": "btc",
  "amount": 1
}

Historical rate (USD to GBP on a specific date)

{
  "from": "usd",
  "to": "gbp",
  "amount": 500,
  "date": "2024-01-15"
}

Convert Ethereum to USD

{
  "from": "eth",
  "to": "usd",
  "amount": 5
}

List all supported currencies

{
  "listCurrencies": true
}

🌐 Supported Currencies

Fiat Currencies: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, INR, and 100+ more

Cryptocurrencies: BTC, ETH, BNB, XRP, ADA, SOL, DOGE, and many more

Metals & Commodities: XAU (Gold), XAG (Silver), XPT (Platinum), etc.

Total: 200+ currencies

⚙️ How It Works

The actor:

• Delivers data via CDN for blazing-fast response
• Updates daily with fresh exchange rates
• Includes automatic fallback mechanism if primary source fails
• Requires no authentication or API keys
• Has no rate limits

📊 Data Source

• Delivery: CDN with automatic fallback
• Update Frequency: Daily
• Coverage: 200+ currencies including fiat, crypto, and metals
• Authentication: None required

---

Made with ❤️ using Apify