--- type: "firecrawl-provider" description: "XE (xe.com) mid-market foreign exchange data read from the public site: convert an amount between two currencies with 7/30/90-day statistics, the full live rate table for a base currency, the historical rate table for any past date, a decoded chart series over 1 day to 10 years, the currency encyclopedia profile of one currency, and the list of every currency XE covers. Anonymous, read-only; money-transfer quoting and account features are out of scope." use_when: "XE (xe.com) mid-market foreign exchange data read from the public site: convert an amount between two currencies with 7/30/90-day statistics, the full live rate table for a base currency, the historical rate table for any past date, a decoded chart series over 1 day to 10 years, the currency encyclopedia profile of one currency, and the list of every currency XE covers. Anonymous, read-only; money-transfer quoting and account features are out of scope." categories: "Finance" capabilities: 6 credits_per_call: 5 --- # XE currency data on Firecrawl Alexandria XE (xe.com) mid-market foreign exchange data read from the public site: convert an amount between two currencies with 7/30/90-day statistics, the full live rate table for a base currency, the historical rate table for any past date, a decoded chart series over 1 day to 10 years, the currency encyclopedia profile of one currency, and the list of every currency XE covers. Anonymous, read-only; money-transfer quoting and account features are out of scope. - Categories: Finance - Category index: [Finance category](https://firecrawl.dev/alexandria/agents/categories/finance) - Provider key: `xe-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/xe-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/xe-com/openapi.json) ## Capabilities - [Convert](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/convert): Convert an amount between two currencies at XE's live mid-market rate. Returns the rate (units of `to` per 1 `from`), its inverse, the converted amount, the rate's timestamp, and XE's 7/30/90-day statistics for the pair (high, low, average, standard deviation, volatility, data points); `stats` is null when the page carries none for the pair. Codes are ISO 4217 or XE's crypto/metal tickers (BTC, XAU). - [Currency profile](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/currency_profile): XE's currency encyclopedia entry for one currency: code, slug, name and plural, issuing country and the countries that use it, symbol and minor unit, coins and banknotes in circulation, central bank (name, URL, policy rate), inflation rate, nicknames, XE's top conversion, tradability, the encyclopedia text as HTML, and the popular live rates XE shows on the page. `currency` is a code (EUR) or the page slug (eur-euro). - [Historical table](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/historical_table): XE's historical rate table for a base currency as of a past date (UTC close, the page's `timestamp` says when): one row per currency with the rate (units per 1 `base`), its inverse and the currency's encyclopedia slug, plus the central-bank policy rates XE lists beside the table. An unknown currency or a date outside XE's series is `not_found`. `quotes` restricts the rows. - [List currencies](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/list_currencies): Every currency in XE's encyclopedia index (about 180 ISO currencies, metals and crypto): code, encyclopedia slug (the `currency_profile` identifier), XE's popularity rank and the index group, sorted by code; plus XE's `popular` shortlist in its order. - [Live rates](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/live_rates): XE's live mid-market table re-based to one currency: one row per currency with the rate (units of that currency per 1 `base`) and its inverse, sorted by code (about 220 codes including obsolete currencies, metals and crypto). `quotes` restricts the rows to the listed codes. - [Rate history](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/rate_history): A time series of XE's mid-market rate for one pair over the last 1 day to 10 years, decoded from XE's charting API and collapsed to one closing value per UTC day (`interval` day, default) or per hour (`hour`, ranges up to 1M). Points are `{time, rate}` with `rate` in units of `to` per 1 `from`. Ranges: 1D, 1W, 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y. ## 1. Choose this provider when XE (xe.com) mid-market foreign exchange data read from the public site: convert an amount between two currencies with 7/30/90-day statistics, the full live rate table for a base currency, the historical rate table for any past date, a decoded chart series over 1 day to 10 years, the currency encyclopedia profile of one currency, and the list of every currency XE covers. Anonymous, read-only; money-transfer quoting and account features are out of scope. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "xe-com", "capability": "exchange-rates/convert", "options": { "amount": 1000, "from": "USD", "to": "BRL" } } ``` ## 3. Add provider options Use only the options needed for the task: - `amount` (number): Amount of `from` to convert. Default 1. Example: `10` - `from` (string, required): Source currency code (USD, EUR, BTC). Case-insensitive. Example: `` - `to` (string, required): Target currency code. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "xe-com", capability: "exchange-rates/convert", options: { amount: 1000, from: "USD", to: "BRL", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "xe-com", "capability": "exchange-rates/convert", "options": { "amount": 1000, "from": "USD", "to": "BRL" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "xe-com", "capability": "exchange-rates/convert", "options": { "amount": 1000, "from": "USD", "to": "BRL" } } }' ``` ### CLI ```sh firecrawl scrape 'xe-com/exchange-rates/convert' \ --options '{"amount":1000,"from":"USD","to":"BRL"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "xe-com", "capability": "exchange-rates/convert", "options": { "amount": 1000, "from": "USD", "to": "BRL" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "xe-com", "capability": "exchange-rates/convert", "options": { "amount": 1000, "from": "USD", "to": "BRL" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "amount": 1000, "converted_amount": 5219.963208, "from": "USD", "inverse_rate": 0.19157223147998861, "observed_at_ms": 1791138120798, "rate": 5.219963208, "rate_timestamp": "2026-10-04T14:45:00Z", "rate_timestamp_ms": 1791125100000, "source_url": "https://www.xe.com/en-us/currencyconverter/convert/?Amount=1000&From=USD&To=BRL", "stats": { "last_30_days": { "average": 5.1503407151, "data_points": 31, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.0869593613, "low_at": "2026-09-09T00:00:00Z", "standard_deviation": 0.0406625445, "volatility": 0.4324101861 }, "last_7_days": { "average": 5.2050907415, "data_points": 8, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.1805939821, "low_at": "2026-10-01T00:00:00Z", "standard_deviation": 0.0182912784, "volatility": 0.5016835735 }, "last_90_days": { "average": 5.140225995, "data_points": 91, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.0671002363, "low_at": "2026-07-23T00:00:00Z", "standard_deviation": 0.0434592205, "volatility": 0.4746809046 } }, "to": "BRL" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Convert - Capability: `exchange-rates/convert` - Description: Convert an amount between two currencies at XE's live mid-market rate. Returns the rate (units of `to` per 1 `from`), its inverse, the converted amount, the rate's timestamp, and XE's 7/30/90-day statistics for the pair (high, low, average, standard deviation, volatility, data points); `stats` is null when the page carries none for the pair. Codes are ISO 4217 or XE's crypto/metal tickers (BTC, XAU). - Instructions: A single pair's current rate or a converted amount. For many quotes against one base use live_rates; for a past date use historical_table. - Cost: 5 credits per call - Capability file: [Convert](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/convert) Accepted options: - `amount` (number): Amount of `from` to convert. Default 1. Example: `10` - `from` (string, required): Source currency code (USD, EUR, BTC). Case-insensitive. Example: `` - `to` (string, required): Target currency code. Example: `` Response schema example: ```json { "amount": 1000, "converted_amount": 5219.963208, "from": "USD", "inverse_rate": 0.19157223147998861, "observed_at_ms": 1791138120798, "rate": 5.219963208, "rate_timestamp": "2026-10-04T14:45:00Z", "rate_timestamp_ms": 1791125100000, "source_url": "https://www.xe.com/en-us/currencyconverter/convert/?Amount=1000&From=USD&To=BRL", "stats": { "last_30_days": { "average": 5.1503407151, "data_points": 31, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.0869593613, "low_at": "2026-09-09T00:00:00Z", "standard_deviation": 0.0406625445, "volatility": 0.4324101861 }, "last_7_days": { "average": 5.2050907415, "data_points": 8, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.1805939821, "low_at": "2026-10-01T00:00:00Z", "standard_deviation": 0.0182912784, "volatility": 0.5016835735 }, "last_90_days": { "average": 5.140225995, "data_points": 91, "high": 5.2246094836, "high_at": "2026-10-02T00:00:00Z", "low": 5.0671002363, "low_at": "2026-07-23T00:00:00Z", "standard_deviation": 0.0434592205, "volatility": 0.4746809046 } }, "to": "BRL" } ``` ### Currency profile - Capability: `exchange-rates/currency_profile` - Description: XE's currency encyclopedia entry for one currency: code, slug, name and plural, issuing country and the countries that use it, symbol and minor unit, coins and banknotes in circulation, central bank (name, URL, policy rate), inflation rate, nicknames, XE's top conversion, tradability, the encyclopedia text as HTML, and the popular live rates XE shows on the page. `currency` is a code (EUR) or the page slug (eur-euro). - Instructions: Reference facts about a currency. For rates use convert, live_rates or historical_table. - Cost: 5 credits per call - Capability file: [Currency profile](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/currency_profile) Accepted options: - `currency` (string, required): Currency code (EUR) or encyclopedia slug (eur-euro) as in list_currencies or historical_table rows. Example: `` Response schema example: ```json { "banknotes": [ { "frequency": "freq", "unit": "major", "value": "5" }, { "frequency": "freq", "unit": "major", "value": "10" }, { "frequency": "freq", "unit": "major", "value": "20" }, { "frequency": "freq", "unit": "major", "value": "50" }, { "frequency": "freq", "unit": "major", "value": "100" }, { "frequency": "rare", "unit": "major", "value": "200" }, { "frequency": "rare", "unit": "major", "value": "500" } ], "central_bank": { "name": "European Central Bank", "url": "https://www.ecb.eu" }, "central_bank_rate": 0.0425, "code": "EUR", "coins": [ { "frequency": "freq", "unit": "minor", "value": "5" }, { "frequency": "freq", "unit": "minor", "value": "10" }, { "frequency": "freq", "unit": "minor", "value": "20" }, { "frequency": "freq", "unit": "minor", "value": "50" }, { "frequency": "freq", "unit": "major", "value": "1" }, { "frequency": "freq", "unit": "major", "value": "2" }, { "frequency": "rare", "unit": "minor", "value": "1" }, { "frequency": "rare", "unit": "minor", "value": "2" } ], "country": "Euro Member Countries", "description_html": "

\r\nThe central bank in Europe is called the European Central Bank (ECB). Currently, 17 EU member states have adopted the Euro. It is the second-most traded currency on the forex market, after the US Dollar, and also a major global reserve currency. Other common names for the Euro include Yoyo (Irish English), Leru (Spanish), and Ege (Finnish).\r\n

\r\n

Introduction of the Euro\r\n
\r\nOn January 1, 1999, the Euro (EUR) was introduced as an account currency, replacing the European Currency Unit at par. The European Currency Unit was a theoretical basket of currencies rather than a physical currency in and of itself. Initially, eleven of the countries in the European Economic and Monetary Union replaced their own currencies with the Euro: Austria, Belgium, Finland, France, Germany, Ireland, Italy, Luxembourg, the Netherlands, Portugal, and Spain. Greece followed suit in 2001, Slovenia in 2007, Malta and Cyprus in 2008, Slovakia in 2009 and Latvia in 2014.\r\n

\r\n

Use of the Euro outside the EU\r\n
\r\nA number of sovereign states that are not part of the European Union have since adopted the Euro, including the Principality of Andorra, the Principality of Monaco, the Republic of San Marino, and the Vatican City. The Euro is also used in many territories, departments, and sovereign states of Euro-zone countries, such as the Azores, Balearic Islands, the Canary Islands, Europa Island, French Guiana, Guadeloupe, Juan de Nova, the Madeira Islands, Martinique, Mayotte, Reunion, Saint-Martin, Saint Pierre and Miquelon, to name just a few. The Euro is used as a trading currency in Cuba, North Korea, and Syria and several currencies are pegged to it.\r\n
\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n
CurrencyPeg Rate
Bosnia and Herzegovina Convertible Mark1.95583
Bulgarian Lev1.95583
Cape Verdean Escudo110.265
Central African CFA Franc BEAC655.957
CFA Franc655.957
CFP Franc119.3317
Comoran Franc491.9678
Lithuanian Litas3.45280
\r\n

\r\n

Value of Obsolete National Currencies\r\n
\r\nEuro bank notes and coins began circulating in 2002 with old notes and coins gradually being withdrawn from circulation. The precise dates that each old currency ceased being legal tender and their official fixed rates are shown in the table below.\r\n
\r\n
\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n\t\r\n\t\t\r\n\t\t\r\n\t\t\r\n\t\r\n
Legacy(Old) CurrencyConversion from EURObsolete
ATS Austria, Schilling1 EUR = 13.7603 ATS28-Feb-2002
BEF Belgium, Franc1 EUR = 40.3399 BEF28-Feb-2002
CYP Cyprus, Pound1 EUR = 0.58527 CYP31-Jan-2008
DEM Germany, Deutsche Mark1 EUR = 1.95583 DEM28-Feb-2002
EEK Estonia, Kroon1 EUR = 15.6466 EEK15-Jan-2011
ESP Spain, Peseta1 EUR = 166.386 ESP28-Feb-2002
FIM Finland, Markka1 EUR = 5.94573 FIM31-Jan-2008
FRF France, Franc1 EUR = 6.55957 FRF17-Feb-2002
GRD Greece, Drachma1 EUR = 340.750 GRD28-Feb-2002
HRK Croatia, Kuna1 EUR = 7.53450 HRK1-Jan-2023
IEP Ireland, Pound1 EUR = 0.78756 IEP9-Feb-2002
ITL Italy, Lira1 EUR = 1936.27 ITL28-Feb-2002
LTL Lithuania, Litas1 EUR = 3.45280 LTL15-Jan-2015
LUF Luxembourg, Franc1 EUR = 40.3399 LUF28-Feb-2002
LVL Latvia, Lats1 EUR = 0.70280 LVL15-Jan-2014
MTL Malta, Lira1 EUR = 0.42930 MTL31-Jan-2008
NLG Netherlands, Guilder (Florin)1 EUR = 2.20371 NLG28-Jan-2008
PTE Portugal, Escudo1 EUR = 200.482 PTE28-Feb-2002
SIT Slovenia, Tolar1 EUR = 239.640 SIT14-Jan-2007
SKK Slovakia, Koruna1 EUR = 30.1260 SKK17-Jan-2009
\r\n
\r\nThe XE Currency Converter supports the above obsolete currencies; to make a conversion, type the name of the currency in the search box. Some old currencies are still physically convertible at special locations. For details, refer to the official ECB site listed in the Relevant Links section below.\r\n

\r\n

Spelling and Capitalization\r\n
\r\nThe official spelling of the EUR currency unit is \"euro\", with a lower case \"e\"; however, the common industry practice is to spell it \"Euro\", with a capital \"E\". Many languages have different official spellings for the Euro, which also may or may not coincide with general use. Additionally, there are various nicknames for the currency including, Ege (Finnish), Pavo (Spanish), and Euráče (Slovak).\r\n

\r\n

Relevant Links\r\n
\r\nFor more information on the EUR, we encourage you to visit the links below, particularly the European Central Bank. These sites include recent news on the Euro as well as issues like implementation, spelling, legislation, and more.\r\n

\r\n", "inflation_rate": 0.015, "is_crypto": false, "is_tradable": true, "minor_unit": { "label": "1/100 = cent", "symbol": "cent", "symbol_on_right": true }, "name": "Euro", "nicknames": [ "Ege (Finnish)", "Pavo (Spanish)", "Yoyo (Irish English)", "Teuro (German)" ], "observed_at_ms": 1791138157658, "plural_name": "Euros", "popular_rates": [ { "from": "EUR", "percentage_change": 0.000045365354305984166, "rate": 1.1257833595765894, "rate_change": 0.00005106924420461567, "to": "USD", "trend": "up" }, { "from": "GBP", "percentage_change": -0.00009928492332196911, "rate": 1.176195647515972, "rate_change": -0.00011679009017040444, "to": "EUR", "trend": "down" }, { "from": "USD", "percentage_change": 0.00017983957156838366, "rate": 157.8555811855, "rate_change": 0.02838357560000304, "to": "JPY", "trend": "up" }, { "from": "GBP", "percentage_change": -0.00005392407311197715, "rate": 1.3241414875798927, "rate_change": -0.00007140695294061139, "to": "USD", "trend": "down" }, { "from": "USD", "percentage_change": -0.0003454897046976361, "rate": 0.8284327365, "rate_change": -0.00028631390000000145, "to": "CHF", "trend": "down" }, { "from": "USD", "percentage_change": 0.00015225246217591683, "rate": 1.4247002484, "rate_change": 0.00021688110000006589, "to": "CAD", "trend": "up" }, { "from": "EUR", "percentage_change": 0.00022521308436019357, "rate": 177.71118651492725, "rate_change": 0.04001387279262758, "to": "JPY", "trend": "up" }, { "from": "AUD", "percentage_change": 0.0015538816556235975, "rate": 0.6955467942915593, "rate_change": 0.001079120578606152, "to": "USD", "trend": "up" } ], "slug": "eur-euro", "source_url": "https://www.xe.com/en-us/currency/eur-euro/", "symbol": "€", "symbol_on_right": false, "top_conversion": { "from": "EUR", "to": "USD" }, "users": [ "Euro Member Countries", "Andorra", "Austria", "Azores", "Baleares (Balearic Islands)", "Belgium", "Canary Islands", "Cyprus", "Finland", "France", "French Guiana", "French Southern Territories", "Germany", "Greece", "Guadeloupe", "Holland (Netherlands)", "Holy See (Vatican City)", "Ireland (Eire)", "Italy", "Luxembourg", "Madeira Islands", "Malta", "Monaco", "Montenegro", "Netherlands", "Portugal", "Réunion", "Saint Pierre and Miquelon", "Saint-Martin", "San Marino", "Slovakia", "Slovenia", "Spain", "Vatican City (The Holy See)", "Estonia", "Lithuania", "Latvia" ] } ``` ### Historical table - Capability: `exchange-rates/historical_table` - Description: XE's historical rate table for a base currency as of a past date (UTC close, the page's `timestamp` says when): one row per currency with the rate (units per 1 `base`), its inverse and the currency's encyclopedia slug, plus the central-bank policy rates XE lists beside the table. An unknown currency or a date outside XE's series is `not_found`. `quotes` restricts the rows. - Instructions: What a rate was on a given day, or a whole day's table. For a time series of one pair use rate_history. - Cost: 5 credits per call - Capability file: [Historical table](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/historical_table) Accepted options: - `base` (string, required): Base currency code. Example: `` - `date` (string, required): Calendar date, YYYY-MM-DD. Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `` - `quotes` (string[]): Only these quote currencies. Example: `[]` Response schema example: ```json { "base": "USD", "central_bank_rates": [ { "currency": "JPY", "rate_percent": 0.75, "slug": "jpy-japanese-yen" }, { "currency": "CHF", "rate_percent": 0, "slug": "chf-swiss-franc" }, { "currency": "EUR", "rate_percent": 4.25, "slug": "eur-euro" }, { "currency": "USD", "rate_percent": 3.75, "slug": "usd-us-dollar" }, { "currency": "CAD", "rate_percent": 2.25, "slug": "cad-canadian-dollar" }, { "currency": "AUD", "rate_percent": 3.6, "slug": "aud-australian-dollar" }, { "currency": "NZD", "rate_percent": 2.25, "slug": "nzd-new-zealand-dollar" }, { "currency": "GBP", "rate_percent": 3.75, "slug": "gbp-british-pound" } ], "count": 4, "date": "2026-09-15", "observed_at_ms": 1791138139144, "rate_timestamp": "2026-09-15T16:00:00Z", "rates": [ { "currency": "EUR", "inverse": 1.1542064070309253, "rate": 0.8663961609539103, "slug": "eur-euro" }, { "currency": "GBP", "inverse": 1.3478241111678746, "rate": 0.7419365714815052, "slug": "gbp-british-pound" }, { "currency": "JPY", "inverse": 0.006447320307048395, "rate": 155.1031982863906, "slug": "jpy-japanese-yen" }, { "currency": "BRL", "inverse": 0.1941846755424421, "rate": 5.149736956361598, "slug": "brl-brazilian-real" } ], "source_url": "https://www.xe.com/en-us/currencytables/?from=USD&date=2026-09-15" } ``` ### List currencies - Capability: `exchange-rates/list_currencies` - Description: Every currency in XE's encyclopedia index (about 180 ISO currencies, metals and crypto): code, encyclopedia slug (the `currency_profile` identifier), XE's popularity rank and the index group, sorted by code; plus XE's `popular` shortlist in its order. - Instructions: Discover valid codes and slugs before calling the other functions. - Cost: 5 credits per call - Capability file: [List currencies](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/list_currencies) Accepted options: Response schema example: ```json { "count": 180, "currencies": [ { "code": "ADA", "group": "A", "popularity": 172, "slug": "ada-cardano" }, { "code": "AED", "group": "A", "popularity": 28, "slug": "aed-emirati-dirham" }, { "code": "AFN", "group": "A", "popularity": 162, "slug": "afn-afghan-afghani" }, { "code": "ALL", "group": "A", "popularity": 77, "slug": "all-albanian-lek" }, { "code": "AMD", "group": "A", "popularity": 126, "slug": "amd-armenian-dram" }, { "code": "ANG", "group": "A", "popularity": 102, "slug": "ang-dutch-guilder" }, { "code": "AOA", "group": "A", "popularity": 114, "slug": "aoa-angolan-kwanza" }, { "code": "ARS", "group": "A", "popularity": 32, "slug": "ars-argentine-peso" }, { "code": "AUD", "group": "A", "popularity": 5, "slug": "aud-australian-dollar" }, { "code": "AWG", "group": "A", "popularity": 125, "slug": "awg-aruban-or-dutch-guilder" }, { "code": "AZN", "group": "A", "popularity": 163, "slug": "azn-azerbaijan-manat" }, { "code": "BAM", "group": "B", "popularity": 44, "slug": "bam-bosnia-herzegovina-convertible-mark" }, { "code": "BBD", "group": "B", "popularity": 70, "slug": "bbd-barbadian-or-bajan-dollar" }, { "code": "BCH", "group": "B", "popularity": 173, "slug": "bch-bitcoin-cash" }, { "code": "BDT", "group": "B", "popularity": 55, "slug": "bdt-bangladeshi-taka" }, { "code": "BGN", "group": "B", "popularity": 12, "slug": "bgn-bulgarian-lev" }, { "code": "BHD", "group": "B", "popularity": 54, "slug": "bhd-bahraini-dinar" }, { "code": "BIF", "group": "B", "popularity": 132, "slug": "bif-burundian-franc" }, { "code": "BMD", "group": "B", "popularity": 79, "slug": "bmd-bermudian-dollar" }, { "code": "BND", "group": "B", "popularity": 110, "slug": "bnd-bruneian-dollar" }, { "code": "BOB", "group": "B", "popularity": 85, "slug": "bob-bolivian-bolíviano" }, { "code": "BRL", "group": "B", "popularity": 24, "slug": "brl-brazilian-real" }, { "code": "BSD", "group": "B", "popularity": 76, "slug": "bsd-bahamian-dollar" }, { "code": "BTC", "group": "B", "popularity": 171, "slug": "btc-bitcoin" }, { "code": "BTN", "group": "B", "popularity": 139, "slug": "btn-bhutanese-ngultrum" }, { "code": "BWP", "group": "B", "popularity": 84, "slug": "bwp-botswana-pula" }, { "code": "BZD", "group": "B", "popularity": 164, "slug": "bzd-belizean-dollar" }, { "code": "CAD", "group": "C", "popularity": 4, "slug": "cad-canadian-dollar" }, { "code": "CDF", "group": "C", "popularity": 143, "slug": "cdf-congolese-franc" }, { "code": "CHF", "group": "C", "popularity": 9, "slug": "chf-swiss-franc" }, { "code": "CLP", "group": "C", "popularity": 33, "slug": "clp-chilean-peso" }, { "code": "CNY", "group": "C", "popularity": 18, "slug": "cny-chinese-yuan-renminbi" }, { "code": "COP", "group": "C", "popularity": 39, "slug": "cop-colombian-peso" }, { "code": "CRC", "group": "C", "popularity": 53, "slug": "crc-costa-rican-colon" }, { "code": "CVE", "group": "C", "popularity": 100, "slug": "cve-cape-verdean-escudo" }, { "code": "CZK", "group": "C", "popularity": 27, "slug": "czk-czech-koruna" }, { "code": "DJF", "group": "D", "popularity": 133, "slug": "djf-djiboutian-franc" }, { "code": "DKK", "group": "D", "popularity": 21, "slug": "dkk-danish-krone" }, { "code": "DOGE", "group": "D", "popularity": 174, "slug": "doge-dogecoin" }, { "code": "DOP", "group": "D", "popularity": 51, "slug": "dop-dominican-peso" }, { "code": "DOT", "group": "D", "popularity": 175, "slug": "dot-polkadot" }, { "code": "DZD", "group": "D", "popularity": 56, "slug": "dzd-algerian-dinar" }, { "code": "EEK", "group": "E", "popularity": 68, "slug": "eek-estonian-kroon" }, { "code": "EGP", "group": "E", "popularity": 34, "slug": "egp-egyptian-pound" }, { "code": "ERN", "group": "E", "popularity": 146, "slug": "ern-eritrean-nakfa" }, { "code": "ETB", "group": "E", "popularity": 106, "slug": "etb-ethiopian-birr" }, { "code": "ETH", "group": "E", "popularity": 176, "slug": "eth-ethereum" }, { "code": "EUR", "group": "E", "popularity": 2, "slug": "eur-euro" }, { "code": "FJD", "group": "F", "popularity": 42, "slug": "fjd-fijian-dollar" }, { "code": "FKP", "group": "F", "popularity": 101, "slug": "fkp-falkland-island-pound" }, { "code": "GBP", "group": "G", "popularity": 3, "slug": "gbp-british-pound" }, { "code": "GEL", "group": "G", "popularity": 105, "slug": "gel-georgian-lari" }, { "code": "GGP", "group": "G", "popularity": 161, "slug": "ggp-guernsey-pound" }, { "code": "GHS", "group": "G", "popularity": 166, "slug": "ghs-ghanaian-cedi" }, { "code": "GIP", "group": "G", "popularity": 141, "slug": "gip-gibraltar-pound" }, { "code": "GMD", "group": "G", "popularity": 124, "slug": "gmd-gambian-dalasi" }, { "code": "GNF", "group": "G", "popularity": 122, "slug": "gnf-guinean-franc" }, { "code": "GTQ", "group": "G", "popularity": 82, "slug": "gtq-guatemalan-quetzal" }, { "code": "GYD", "group": "G", "popularity": 97, "slug": "gyd-guyanese-dollar" }, { "code": "HKD", "group": "H", "popularity": 14, "slug": "hkd-hong-kong-dollar" }, { "code": "HNL", "group": "H", "popularity": 88, "slug": "hnl-honduran-lempira" }, { "code": "HRK", "group": "H", "popularity": 47, "slug": "hrk-croatian-kuna" }, { "code": "HTG", "group": "H", "popularity": 94, "slug": "htg-haitian-gourde" }, { "code": "HUF", "group": "H", "popularity": 17, "slug": "huf-hungarian-forint" }, { "code": "IDR", "group": "I", "popularity": 26, "slug": "idr-indonesian-rupiah" }, { "code": "ILS", "group": "I", "popularity": 31, "slug": "ils-israeli-shekel" }, { "code": "IMP", "group": "I", "popularity": 158, "slug": "imp-isle-of-man-pound" }, { "code": "INR", "group": "I", "popularity": 7, "slug": "inr-indian-rupee" }, { "code": "IQD", "group": "I", "popularity": 40, "slug": "iqd-iraqi-dinar" }, { "code": "ISK", "group": "I", "popularity": 45, "slug": "isk-icelandic-krona" }, { "code": "JEP", "group": "J", "popularity": 159, "slug": "jep-jersey-pound" }, { "code": "JMD", "group": "J", "popularity": 49, "slug": "jmd-jamaican-dollar" }, { "code": "JOD", "group": "J", "popularity": 50, "slug": "jod-jordanian-dinar" }, { "code": "JPY", "group": "J", "popularity": 6, "slug": "jpy-japanese-yen" }, { "code": "KES", "group": "K", "popularity": 57, "slug": "kes-kenyan-shilling" }, { "code": "KGS", "group": "K", "popularity": 138, "slug": "kgs-kyrgyzstani-som" }, { "code": "KHR", "group": "K", "popularity": 111, "slug": "khr-cambodian-riel" }, { "code": "KMF", "group": "K", "popularity": 154, "slug": "kmf-comorian-franc" }, { "code": "KRW", "group": "K", "popularity": 30, "slug": "krw-south-korean-won" }, { "code": "KWD", "group": "K", "popularity": 43, "slug": "kwd-kuwaiti-dinar" }, { "code": "KYD", "group": "K", "popularity": 98, "slug": "kyd-caymanian-dollar" }, { "code": "KZT", "group": "K", "popularity": 117, "slug": "kzt-kazakhstani-tenge" }, { "code": "LAK", "group": "L", "popularity": 128, "slug": "lak-lao-kip" }, { "code": "LBP", "group": "L", "popularity": 72, "slug": "lbp-lebanese-pound" }, { "code": "LINK", "group": "L", "popularity": 177, "slug": "link-chainlink" }, { "code": "LKR", "group": "L", "popularity": 59, "slug": "lkr-sri-lankan-rupee" }, { "code": "LRD", "group": "L", "popularity": 150, "slug": "lrd-liberian-dollar" }, { "code": "LSL", "group": "L", "popularity": 151, "slug": "lsl-basotho-loti" }, { "code": "LTC", "group": "L", "popularity": 178, "slug": "ltc-litecoin" }, { "code": "LTL", "group": "L", "popularity": 89, "slug": "ltl-lithuanian-litas" }, { "code": "LUNA", "group": "L", "popularity": 179, "slug": "luna-terra" }, { "code": "LVL", "group": "L", "popularity": 80, "slug": "lvl-latvian-lat" }, { "code": "LYD", "group": "L", "popularity": 120, "slug": "lyd-libyan-dinar" }, { "code": "MAD", "group": "M", "popularity": 46, "slug": "mad-moroccan-dirham" }, { "code": "MDL", "group": "M", "popularity": 107, "slug": "mdl-moldovan-leu" }, { "code": "MGA", "group": "M", "popularity": 104, "slug": "mga-malagasy-ariary" }, { "code": "MKD", "group": "M", "popularity": 113, "slug": "mkd-macedonian-denar" }, { "code": "MMK", "group": "M", "popularity": 116, "slug": "mmk-burmese-kyat" }, { "code": "MNT", "group": "M", "popularity": 134, "slug": "mnt-mongolian-tughrik" }, { "code": "MOP", "group": "M", "popularity": 118, "slug": "mop-macau-pataca" }, { "code": "MRU", "group": "M", "popularity": 145, "slug": "mru-mauritanian-ouguiya" }, { "code": "MUR", "group": "M", "popularity": 74, "slug": "mur-mauritian-rupee" }, { "code": "MVR", "group": "M", "popularity": 144, "slug": "mvr-maldivian-rufiyaa" }, { "code": "MWK", "group": "M", "popularity": 130, "slug": "mwk-malawian-kwacha" }, { "code": "MXN", "group": "M", "popularity": 20, "slug": "mxn-mexican-peso" }, { "code": "MYR", "group": "M", "popularity": 22, "slug": "myr-malaysian-ringgit" }, { "code": "MZN", "group": "M", "popularity": 119, "slug": "mzn-mozambican-metical" }, { "code": "NAD", "group": "N", "popularity": 112, "slug": "nad-namibian-dollar" }, { "code": "NGN", "group": "N", "popularity": 71, "slug": "ngn-nigerian-naira" }, { "code": "NIO", "group": "N", "popularity": 91, "slug": "nio-nicaraguan-cordoba" }, { "code": "NOK", "group": "N", "popularity": 19, "slug": "nok-norwegian-krone" }, { "code": "NPR", "group": "N", "popularity": 93, "slug": "npr-nepalese-rupee" }, { "code": "NZD", "group": "N", "popularity": 8, "slug": "nzd-new-zealand-dollar" }, { "code": "OMR", "group": "O", "popularity": 60, "slug": "omr-omani-rial" }, { "code": "PAB", "group": "P", "popularity": 95, "slug": "pab-panamanian-balboa" }, { "code": "PEN", "group": "P", "popularity": 52, "slug": "pen-peruvian-sol" }, { "code": "PGK", "group": "P", "popularity": 115, "slug": "pgk-papua-new-guinean-kina" }, { "code": "PHP", "group": "P", "popularity": 25, "slug": "php-philippine-peso" }, { "code": "PKR", "group": "P", "popularity": 38, "slug": "pkr-pakistani-rupee" }, { "code": "PLN", "group": "P", "popularity": 23, "slug": "pln-polish-zloty" }, { "code": "PYG", "group": "P", "popularity": 87, "slug": "pyg-paraguayan-guarani" }, { "code": "QAR", "group": "Q", "popularity": 61, "slug": "qar-qatari-riyal" }, { "code": "RON", "group": "R", "popularity": 36, "slug": "ron-romanian-leu" }, { "code": "RSD", "group": "R", "popularity": 92, "slug": "rsd-serbian-dinar" }, { "code": "RWF", "group": "R", "popularity": 142, "slug": "rwf-rwandan-franc" }, { "code": "SAR", "group": "S", "popularity": 37, "slug": "sar-saudi-arabian-riyal" }, { "code": "SBD", "group": "S", "popularity": 140, "slug": "sbd-solomon-islander-dollar" }, { "code": "SCR", "group": "S", "popularity": 137, "slug": "scr-seychellois-rupee" }, { "code": "SDG", "group": "S", "popularity": 167, "slug": "sdg-sudanese-pound" }, { "code": "SEK", "group": "S", "popularity": 15, "slug": "sek-swedish-krona" }, { "code": "SGD", "group": "S", "popularity": 13, "slug": "sgd-singapore-dollar" }, { "code": "SHP", "group": "S", "popularity": 152, "slug": "shp-saint-helenian-pound" }, { "code": "SLE", "group": "S", "popularity": 121, "slug": "sle-sierra-leonean-leone" }, { "code": "SLL", "group": "S", "popularity": 121, "slug": "sll-sierra-leonean-leone" }, { "code": "SOS", "group": "S", "popularity": 147, "slug": "sos-somali-shilling" }, { "code": "SPL", "group": "S", "popularity": 155, "slug": "spl-seborgan-luigino" }, { "code": "SRD", "group": "S", "popularity": 157, "slug": "srd-surinamese-dollar" }, { "code": "STN", "group": "S", "popularity": 153, "slug": "stn-sao-tomean-dobra" }, { "code": "SVC", "group": "S", "popularity": 96, "slug": "svc-salvadoran-colon" }, { "code": "SZL", "group": "S", "popularity": 148, "slug": "szl-swazi-lilangeni" }, { "code": "THB", "group": "T", "popularity": 16, "slug": "thb-thai-baht" }, { "code": "TJS", "group": "T", "popularity": 149, "slug": "tjs-tajikistani-somoni" }, { "code": "TMT", "group": "T", "popularity": 156, "slug": "tmt-turkmenistani-manat" }, { "code": "TND", "group": "T", "popularity": 65, "slug": "tnd-tunisian-dinar" }, { "code": "TOP", "group": "T", "popularity": 136, "slug": "top-tongan-pa'anga" }, { "code": "TRY", "group": "T", "popularity": 35, "slug": "try-turkish-lira" }, { "code": "TTD", "group": "T", "popularity": 66, "slug": "ttd-trinidadian-dollar" }, { "code": "TVD", "group": "T", "popularity": 160, "slug": "tvd-tuvaluan-dollar" }, { "code": "TWD", "group": "T", "popularity": 29, "slug": "twd-taiwan-new-dollar" }, { "code": "TZS", "group": "T", "popularity": 99, "slug": "tzs-tanzanian-shilling" }, { "code": "UAH", "group": "U", "popularity": 81, "slug": "uah-ukrainian-hryvnia" }, { "code": "UGX", "group": "U", "popularity": 103, "slug": "ugx-ugandan-shilling" }, { "code": "UNI", "group": "U", "popularity": 182, "slug": "uni-uniswap" }, { "code": "USD", "group": "U", "popularity": 1, "slug": "usd-us-dollar" }, { "code": "UYU", "group": "U", "popularity": 78, "slug": "uyu-uruguayan-peso" }, { "code": "UZS", "group": "U", "popularity": 135, "slug": "uzs-uzbekistani-som" }, { "code": "VEF", "group": "V", "popularity": 169, "slug": "vef-venezuelan-bolívar" }, { "code": "VES", "group": "V", "popularity": 168, "slug": "ves-venezuelan-bolívar" }, { "code": "VND", "group": "V", "popularity": 48, "slug": "vnd-vietnamese-dong" }, { "code": "VUV", "group": "V", "popularity": 108, "slug": "vuv-ni-vanuatu-vatu" }, { "code": "WST", "group": "W", "popularity": 129, "slug": "wst-samoan-tala" }, { "code": "XAF", "group": "X", "popularity": 73, "slug": "xaf-central-african-cfa-franc-beac" }, { "code": "XAG", "group": "X", "popularity": 58, "slug": "xag-silver-ounce" }, { "code": "XAU", "group": "X", "popularity": 41, "slug": "xau-gold-ounce" }, { "code": "XCD", "group": "X", "popularity": 64, "slug": "xcd-east-caribbean-dollar" }, { "code": "XCG", "group": "X", "popularity": 102, "slug": "xcg-caribbean-guilder" }, { "code": "XDR", "group": "X", "popularity": 83, "slug": "xdr-imf-special-drawing-rights" }, { "code": "XLM", "group": "X", "popularity": 183, "slug": "xlm-stellar-lumen" }, { "code": "XOF", "group": "X", "popularity": 62, "slug": "xof-cfa-franc" }, { "code": "XPD", "group": "X", "popularity": 170, "slug": "xpd-palladium-ounce" }, { "code": "XPF", "group": "X", "popularity": 67, "slug": "xpf-cfp-franc" }, { "code": "XPT", "group": "X", "popularity": 75, "slug": "xpt-platinum-ounce" }, { "code": "XRP", "group": "X", "popularity": 184, "slug": "xrp-ripple" }, { "code": "YER", "group": "Y", "popularity": 127, "slug": "yer-yemeni-rial" }, { "code": "ZAR", "group": "Z", "popularity": 10, "slug": "zar-south-african-rand" }, { "code": "ZMK", "group": "Z", "popularity": 69, "slug": "zmk-zambian-kwacha" }, { "code": "ZMW", "group": "Z", "popularity": 69, "slug": "zmw-zambian-kwacha" }, { "code": "ZWD", "group": "Z", "popularity": 90, "slug": "zwd-zimbabwean-dollar" }, { "code": "ZWG", "group": "Z", "popularity": 90, "slug": "zwg-zimbabwean-dollar" }, { "code": "ZWL", "group": "Z", "popularity": 90, "slug": "zwl-zimbabwean-dollar" } ], "observed_at_ms": 1791138166820, "popular": [ "USD", "EUR", "GBP", "CAD", "AUD", "JPY" ], "source_url": "https://www.xe.com/en-us/currency/" } ``` ### Live rates - Capability: `exchange-rates/live_rates` - Description: XE's live mid-market table re-based to one currency: one row per currency with the rate (units of that currency per 1 `base`) and its inverse, sorted by code (about 220 codes including obsolete currencies, metals and crypto). `quotes` restricts the rows to the listed codes. - Instructions: Many rates against one base in one call. For one pair with statistics use convert. - Cost: 5 credits per call - Capability file: [Live rates](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/live_rates) Accepted options: - `base` (string): Base currency code. Default USD. Example: `` - `quotes` (string[]): Only these quote currencies, in this order. Each must be a code XE publishes. Example: `[]` Response schema example: ```json { "base": "EUR", "count": 4, "observed_at_ms": 1791138129597, "rate_timestamp": "2026-10-04T10:43:00Z", "rate_timestamp_ms": 1791110580000, "rates": [ { "currency": "USD", "inverse": 0.8881977461, "rate": 1.1258754082533018 }, { "currency": "GBP", "inverse": 1.1761991422232803, "rate": 0.850196165004657 }, { "currency": "CHF", "inverse": 1.071695147602776, "rate": 0.9331011736283891 }, { "currency": "JPY", "inverse": 0.00562656175395939, "rate": 177.728432340817 } ], "source_url": "https://www.xe.com/en-us/currencyconverter/convert/?Amount=1&From=EUR&To=USD" } ``` ### Rate history - Capability: `exchange-rates/rate_history` - Description: A time series of XE's mid-market rate for one pair over the last 1 day to 10 years, decoded from XE's charting API and collapsed to one closing value per UTC day (`interval` day, default) or per hour (`hour`, ranges up to 1M). Points are `{time, rate}` with `rate` in units of `to` per 1 `from`. Ranges: 1D, 1W, 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y. - Instructions: Charting or trend analysis of one pair. For a single past date across all currencies use historical_table. - Cost: 5 credits per call - Capability file: [Rate history](https://firecrawl.dev/alexandria/agents/providers/xe-com/exchange-rates/rate_history) Accepted options: - `from` (string, required): from Example: `` - `interval` (string): One closing value per UTC day (default) or per hour (ranges up to 1M). Example: `day` - `range` (string): How far back from XE's latest point. Default 1M. Example: `1D` - `to` (string, required): to Example: `` Response schema example: ```json { "count": 31, "from": "EUR", "interval": "day", "observed_at_ms": 1791138149116, "points": [ { "rate": 181.5467827188504, "time": "2026-09-04T23:00:00Z" }, { "rate": 181.46023265875257, "time": "2026-09-05T23:00:00Z" }, { "rate": 181.4243612439205, "time": "2026-09-06T23:00:00Z" }, { "rate": 179.24112988736468, "time": "2026-09-07T23:00:00Z" }, { "rate": 178.74330616683793, "time": "2026-09-08T23:00:00Z" }, { "rate": 178.45636513380703, "time": "2026-09-09T23:00:00Z" }, { "rate": 179.25722327721917, "time": "2026-09-10T23:00:00Z" }, { "rate": 178.17237539053545, "time": "2026-09-11T23:00:00Z" }, { "rate": 178.12774782134622, "time": "2026-09-12T23:00:00Z" }, { "rate": 178.15564295434916, "time": "2026-09-13T23:00:00Z" }, { "rate": 178.2045772231668, "time": "2026-09-14T23:00:00Z" }, { "rate": 178.98892401788382, "time": "2026-09-15T23:00:00Z" }, { "rate": 179.17021299771832, "time": "2026-09-16T23:00:00Z" }, { "rate": 179.01858865637524, "time": "2026-09-17T23:00:00Z" }, { "rate": 180.21141634168953, "time": "2026-09-18T23:00:00Z" }, { "rate": 180.17425481492657, "time": "2026-09-19T23:00:00Z" }, { "rate": 180.3205419528557, "time": "2026-09-20T23:00:00Z" }, { "rate": 180.36279501736547, "time": "2026-09-21T23:00:00Z" }, { "rate": 180.2523180953012, "time": "2026-09-22T23:00:00Z" }, { "rate": 180.2081763423373, "time": "2026-09-23T23:00:00Z" }, { "rate": 180.64162129597315, "time": "2026-09-24T23:00:00Z" }, { "rate": 179.19751198676266, "time": "2026-09-25T23:00:00Z" }, { "rate": 179.18248845970078, "time": "2026-09-26T23:00:00Z" }, { "rate": 179.23111261823215, "time": "2026-09-27T23:45:00Z" }, { "rate": 178.89841529284155, "time": "2026-09-28T23:45:00Z" }, { "rate": 178.50093605209736, "time": "2026-09-29T23:45:00Z" }, { "rate": 178.42650810236285, "time": "2026-09-30T23:45:00Z" }, { "rate": 177.54230465955996, "time": "2026-10-01T23:45:00Z" }, { "rate": 177.65872165548544, "time": "2026-10-02T23:50:00Z" }, { "rate": 177.64271760506725, "time": "2026-10-03T23:50:00Z" }, { "rate": 177.70288930566767, "time": "2026-10-04T18:21:00Z" } ], "range": "1M", "series_timestamp": "2026-10-04T18:22:00Z", "source_url": "https://www.xe.com/en-us/currencycharts/?from=EUR&to=JPY", "to": "JPY" } ```