XE Currency Converter Scraper

Convert currency amounts, pull live or historical exchange-rate tables, and look up currency metadata for 180+ world and crypto currencies — powered by xe.com's public currency data. No login, API key, cookies, or proxy required.

What this actor does

• Three modes: convert, ratesTable, currencyInfo
• Live conversion: convert any amount between any two of 180+ currencies
• Full rate tables: every currency's rate against a base currency, live or on a historical date
• Historical rates: daily-close exchange rates back to ~1995
• Currency metadata: full name, plural name, crypto flag, obsolete flag, buy/sell availability
• Crypto support: BTC, ETH, LTC, XRP, and more, alongside fiat currencies
• Empty fields are omitted

Output per record

mode=convert (conversion record)

• fromCurrency, fromCurrencyName, toCurrency, toCurrencyName
• amount, convertedAmount, exchangeRate, inverseRate
• timestamp — when the underlying rate was captured
• rate7dHigh, rate7dLow, rate7dAverage, rate7dVolatilityPercent, rate7dStandardDeviation, rate7dDataPoints, rate7dHighTimestamp, rate7dLowTimestamp — 7-day rate history stats for this pair
• rate30dHigh, rate30dLow, rate30dAverage, rate30dVolatilityPercent, rate30dStandardDeviation, rate30dDataPoints, rate30dHighTimestamp, rate30dLowTimestamp — 30-day rate history stats
• rate90dHigh, rate90dLow, rate90dAverage, rate90dVolatilityPercent, rate90dStandardDeviation, rate90dDataPoints, rate90dHighTimestamp, rate90dLowTimestamp — 90-day rate history stats
• sourceUrl — the xe.com converter page for this pair
• recordType: "conversion", scrapedAt

mode=ratesTable (one record per target currency)

• baseCurrency, baseCurrencyName, targetCurrency, targetCurrencyName
• rate, inverseRate
• isCrypto, isObsolete (only present when true)
• date (historical lookups only), timestamp
• liveTrend, liveRateChangeValue, liveRateChangePercent — today's live up/down movement, only for live (non-historical) rows and only for the handful of major pairs xe.com tracks on its live ticker (e.g. EUR/USD, USD/JPY, GBP/USD, USD/CHF, USD/CAD, EUR/JPY, AUD/USD, GBP/EUR)
• centralBankInterestRatePercent — the target currency's current central-bank benchmark interest rate, only for live (non-historical) rows and only for the handful of major currencies xe.com publishes this for (USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD)
• sourceUrl — xe.com's currency encyclopedia page for the target currency
• recordType: "rate", scrapedAt

mode=currencyInfo (currency metadata record)

• currencyCode, name, namePlural
• isCrypto, isObsolete, isSellable, isBuyable
• sourceUrl — xe.com's currency encyclopedia page, or its converter page as a fallback (only ever a link that's been checked to actually resolve; omitted entirely for the handful of currencies XE no longer publishes any page for, e.g. sanctioned/discontinued ones)
• country — the country/region primarily associated with this currency
• currencySymbol, minorUnitSymbol, minorUnitLabel — e.g. $, ¢, 1/100 = cent
• centralBankName, centralBankUrl — the issuing central bank
• centralBankRatePercent, inflationRatePercent — current benchmark interest rate and inflation rate, as published by xe.com
• nicknames — informal names for the currency (e.g. "buck", "greenback")
• usedInCountries — countries/territories that use this currency
• coinDenominations, banknoteDenominations — coins/banknotes in circulation, formatted with the currency's own symbol (e.g. ["1¢", "5¢", ..., "50¢ (rare)"], ["$1", "$5", ..., "$100"]); omitted for currencies with no physical coins/notes (e.g. crypto)
• shortDescription — a short one-line summary xe.com publishes for a subset of currencies (mostly crypto, e.g. "Ethereum is a decentralized open-source blockchain system..."); omitted when xe.com doesn't publish one
• description — xe.com's currency-encyclopedia write-up (history, usage, notable facts), plain text
• isTradable
• replacedByCurrency, replacedByCurrencyName — for retired currencies, the successor currency xe.com itself names (e.g. DEM -> EUR), when published
• recordType: "currencyInfo", scrapedAt

The extended fields (country through isTradable) come from xe.com's currency-encyclopedia page and are only included when includeExtendedInfo: true (default) and xe.com actually publishes that page/field for the currency.

Input

Field	Type	Default	Description
mode	string	convert	convert / ratesTable / currencyInfo
amount	number	1	Amount to convert (mode=convert)
fromCurrency	string	USD	Source currency (mode=convert) / base currency (mode=ratesTable)
toCurrency	string	EUR	Target currency (mode=convert)
toCurrencies	array	[]	Convert into multiple currencies at once (mode=convert), one record per currency from a single live-rates snapshot. Empty = use only toCurrency
date	string	–	Historical date YYYY-MM-DD (mode=ratesTable). Leave empty for the latest daily table. Ignored when dates is set
dates	array	[]	Batch of historical dates YYYY-MM-DD (mode=ratesTable, up to 20), fetched in one run to build a trend series. Overrides date when non-empty
targetCurrencies	array	[]	Restrict ratesTable / currencyInfo output to these currency codes. Empty = all
sortBy	string	currencyCodeAsc	Row order for ratesTable: currencyCodeAsc / rateAsc / rateDesc
includeCryptoCurrencies	boolean	true	Include crypto assets in ratesTable / currencyInfo
includeObsoleteCurrencies	boolean	false	Include retired currencies (pre-Euro DEM, FRF, ...)
includeExtendedInfo	boolean	true	currencyInfo only: fetch country, symbol, central bank, inflation rate, nicknames, used-in countries and description from xe.com's currency encyclopedia (one extra request per currency; disable for faster runs)
maxItems	int	50	Hard cap on emitted records (1–250)

Example: convert an amount

{
  "mode": "convert",
  "amount": 500,
  "fromCurrency": "USD",
  "toCurrency": "JPY"
}

Example: convert an amount into several currencies at once

{
  "mode": "convert",
  "amount": 500,
  "fromCurrency": "USD",
  "toCurrencies": ["EUR", "JPY", "GBP"]
}

Example: today's full rate table for EUR

{
  "mode": "ratesTable",
  "fromCurrency": "EUR",
  "sortBy": "rateAsc",
  "maxItems": 50
}

Example: historical rates on a specific date, restricted to a few currencies

{
  "mode": "ratesTable",
  "fromCurrency": "GBP",
  "date": "2020-06-15",
  "targetCurrencies": ["USD", "EUR", "JPY"]
}

Example: currency metadata lookup

{
  "mode": "currencyInfo",
  "targetCurrencies": ["USD", "BTC", "INR"]
}

Use cases

• Finance apps — build a live currency converter or price checker
• E-commerce — display localized prices across storefronts
• Accounting / invoicing — convert transaction amounts for reporting
• Historical analysis — pull daily rate history for a currency pair over time
• Crypto dashboards — track crypto-to-fiat rates alongside traditional currencies
• Data enrichment — attach currency names, obsolete/crypto flags to a dataset of currency codes

FAQ

Where does the data come from? xe.com, one of the most widely used currency-conversion services online. Rates are sourced from XE's mid-market feed and updated throughout the trading day; the daily rate table is a once-per-day close snapshot.

How far back does historical data go? XE's daily rate table reliably covers 1998 onward, with a growing number of currencies the more recent the date (e.g. ~44 currencies in early 1998, 140+ from the early 2000s on). Some dates between 1995-1997 may return no data at all for a given base currency, in which case the actor returns a clear "no rate table" message rather than partial/fabricated data. Today's date and future dates are always rejected with a clear error.

Why do some currencies show isObsolete: true? These are retired currencies (e.g. the German Deutsche Mark, French Franc — replaced by the Euro). They're excluded from ratesTable / currencyInfo by default; set includeObsoleteCurrencies: true to include them. Note that XE's daily rate table itself often doesn't carry rows for these legacy currencies even on dates before they were retired — in that case currencyInfo (which always has metadata) is the more reliable mode for looking them up. When XE publishes the successor currency for a retired one, currencyInfo also includes replacedByCurrency / replacedByCurrencyName (e.g. DEM -> replacedByCurrency: "EUR").

What currency codes are supported? 180+ active ISO currency codes plus major cryptocurrencies (BTC, ETH, LTC, XRP, ADA, DOGE, and more). Pick from the dropdown in each currency field, or check the currencyInfo mode output for the full list.

Is mode=convert real-time? It reflects XE's live quoted mid-market rate at request time, refreshed frequently throughout the day.

Can I get rates for a currency pair that isn't USD-based? Yes — mode=convert computes the cross-rate between any two supported currencies directly (e.g. GBP → JPY), not just versus USD.

Do I need a proxy or API key? No. This actor reads xe.com's public pages directly; no login, cookies, or paid API key needed.

What do the rate7dHigh/rate30dHigh/rate90dHigh etc. fields mean? For mode=convert, XE also publishes rolling 7/30/90-day statistics for the requested pair: the highest and lowest rate seen (plus the exact UTC timestamp each occurred), the average rate, the standard deviation, the number of daily data points behind the stat, and the volatility (the day-to-day fluctuation, as a percentage) over that window. These are only included when fromCurrency and toCurrency differ, and each sub-field is only present when XE actually returns it for that window.

What's in the extended currencyInfo fields (country, central bank, nicknames, ...)? These come straight from xe.com's public currency-encyclopedia page for that currency — the same page a visitor sees at xe.com/currency/<code>-<name>/. Every link the actor emits is checked live before being returned; for the small number of currencies xe.com no longer publishes any page for (currently a handful of sanctioned/discontinued currencies such as the Russian Ruble or North Korean Won), sourceUrl and the extended fields are simply omitted rather than pointing at a dead link.