# ECB Exchange Rates Scraper — Free FX Data 1999–Today | $0.50/1K (`bovi/exchange-rates-scraper`) Actor Fetch live and historical currency exchange rates from the European Central Bank (ECB) via api.frankfurter.app. Free ECB open data. Supports latest rates, historical lookup, and time series back to 1999. No API key. No proxy. No rate limit. One row per currency pair per date. - **URL**: https://apify.com/bovi/exchange-rates-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Developer tools, MCP servers, AI - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.97 / 1,000 ecb exchange rates scraper — free fx data 1999–today | $0.50/1ks This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ECB Exchange Rates Scraper — Free FX Data 1999–Today | No API Key | from $0.50/1K For finance teams, accountants, and data engineers who need clean, audit-grade historical FX rates for invoice conversion, portfolio valuation, or regulatory reporting — at near-zero cost. **No API key. No proxy. No rate limit.** ECB open data back to 1999. **$0.50 per 1,000 rows** (Pay Per Event). A typical run: all currencies today = ~30 rows ≈ $0.02. Full 2025 EUR/USD daily = 252 rows ≈ $0.13. Fetch live and historical currency exchange rates from the European Central Bank (ECB) via the free, public [Frankfurter API](https://www.frankfurter.app/). No API key. No proxy. No auth. Unlimited history back to 1999. ### Features - **Three modes:** latest (today's ECB snapshot), historical (single date), timeseries (full date range) - **Flat output:** one row per `(date, base, quote)` triple — ready for spreadsheets, databases, pipelines - **30 ECB currencies** including USD, EUR, GBP, JPY, CAD, CHF, AUD, CNY, and more - **Parse confidence** field in every row — machine-readable quality signal - **Pay per result** — no wasted spend on headers or metadata rows ### Input | Field | Type | Default | Description | |---|---|---|---| | `baseCurrency` | string | `USD` | ISO 4217 base currency | | `symbols` | string\[] | all | Quote currencies to return | | `mode` | select | `latest` | `latest` / `historical` / `timeseries` | | `startDate` | string | — | YYYY-MM-DD (required for historical/timeseries) | | `endDate` | string | today | YYYY-MM-DD (timeseries end) | | `maxResults` | integer | 0 (no limit) | Cap total rows for cost control | ### Output One dataset row per `(date, base_currency, quote_currency)` triple: | Field | Type | Example | |---|---|---| | `date` | string (ISO date) | `2026-05-29` | | `base_currency` | string | `USD` | | `quote_currency` | string | `EUR` | | `rate` | float | `0.85881` | | `amount` | float | `1.0` | | `mode` | string | `latest` | | `scraped_at` | string (ISO UTC) | `2026-05-29T12:00:00Z` | | `parse_confidence` | float \[0–1] | `1.0` | | `warnings` | string\[] | `[]` | **Interpretation:** `1 USD = 0.85881 EUR` on 2026-05-29. ### Pricing example Pay per result (PPE). **$0.50 per 1,000 rows.** | Fetch | Records | Cost | |---|---|---| | Latest rates, all 30 currencies | ~30 rows | ~$0.02 | | 1 month EUR/USD daily | ~22 rows | ~$0.01 | | 1 year EUR→USD, GBP, JPY | ~780 rows | ~$0.39 | | Full 2025 all-currencies timeseries | ~7,500 rows | ~$3.75 | ### FAQ **Do I need an API key or account?** No. The Frankfurter API is a free, public ECB data service. No registration, no key, no rate limit documented. **What currencies are supported?** 30 ECB currencies: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR. ECB does not publish rates for all world currencies. **Can I schedule this to run automatically?** Yes. Schedule in Apify Console (e.g. daily at 16:30 CET after ECB publishes) or trigger via webhook from n8n / Make to feed your FX pipeline automatically. **What if a date returns no data?** Weekend and holiday dates automatically snap to the previous ECB business day. If the API is unavailable, the actor logs the error and pushes nothing — you are not charged. ### Data source [Frankfurter](https://www.frankfurter.app/) — open-source API backed by ECB reference exchange rates. Published daily at ~16:00 CET on business days. Weekend/holiday dates snap to previous business day automatically. ### Supported currencies AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, USD, ZAR. ### Use cases - Financial data pipelines (spreadsheets, BI tools, databases) - Portfolio valuation at historical dates - FX trend analysis and backtesting - Invoice currency conversion audit trails - Academic / research datasets ### Competitor comparison | Source | Cost | History depth | Currencies | |---|---|---|---| | **This actor** (ECB/Frankfurter) | $0.50/1K rows | 1999–today | 30 ECB currencies | | Open Exchange Rates | $12–97/mo | 1999–today | 170 currencies | | Fixer.io | $13–97/mo | 2000–today | 170 currencies | | exchangerate-api.com | Free (1,500/mo) then paid | 6 mo | 162 currencies | ECB data is free, audit-grade, and published daily. The actor wraps 27 years of history into clean flat rows — one per `(date, base, quote)` triple. ### Use with AI agents (MCP) This actor is callable as a **tool by AI agents** (Claude Desktop, Cursor, VS Code, n8n, LangGraph, CrewAI, or any MCP-compatible client) via Apify's hosted Model Context Protocol server. An agent uses it to **look up historical or live FX rates mid-conversation** — e.g. "convert $500 to EUR at the 2024-12-31 rate", "what was the USD/JPY rate last week". Point your MCP client at this tool: ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/exchange-rates-scraper", "--header", "Authorization: Bearer " ] } } } ``` Minimal input an agent can send: ```json { "mode": "latest", "baseCurrency": "USD", "symbols": ["EUR", "GBP", "JPY"] } ``` ### Also in this finance family - [Yahoo Finance Scraper](https://apify.com/bovi/yahoo-finance-scraper) — stocks, ETFs, crypto, indices, forex - [CoinGecko Scraper](https://apify.com/bovi/coingecko-scraper) — live crypto prices, market caps, all coins - [Binance Scraper](https://apify.com/bovi/binance-scraper) — spot prices + OHLCV klines for 3,500+ pairs - [Dexscreener Scraper](https://apify.com/bovi/dexscreener-scraper) — DEX pairs, on-chain token prices across 50+ chains - [DefiLlama Scraper](https://apify.com/bovi/defillama-scraper) — DeFi protocol TVL + yield pool APY ### Integrations Built for finance teams and data engineers pulling audit-grade ECB historical FX rates into pipelines and reports — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). # Actor input Schema ## `baseCurrency` (type: `string`): ISO 4217 currency code to use as the base (denominator). Example: USD, EUR, GBP. Defaults to EUR. ## `symbols` (type: `array`): ISO 4217 currency codes to convert to. Leave empty to get all ~30 ECB currencies. Example: EUR, GBP, JPY. ## `mode` (type: `string`): latest: today's ECB rate (1 date). historical: rates on a single past date (startDate required). timeseries: rates for a date range (startDate + endDate required, one row per business day per currency pair). ## `startDate` (type: `string`): Required for mode=historical and mode=timeseries. ISO 8601 date: YYYY-MM-DD. ECB data goes back to 1999-01-04. Weekend/holiday dates snap to the previous business day. Example: 2025-01-01 ## `endDate` (type: `string`): End date for mode=timeseries. ISO 8601 date: YYYY-MM-DD. Must be >= startDate. Defaults to today if omitted. Example: 2025-12-31 ## `maxResults` (type: `integer`): Maximum total rows to return (across all dates and currency pairs). 0 = no limit. Useful for cost control on wide time series. ## Actor input object example ```json { "baseCurrency": "USD", "symbols": [ "EUR", "GBP", "JPY", "CAD", "CHF" ], "mode": "latest", "startDate": "2025-01-01", "endDate": "2025-12-31" } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing Exchange Rates Scraper records (date, base\_currency, quote\_currency, rate, amount, mode, scraped\_at, parse\_confidence, warnings). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "baseCurrency": "USD", "symbols": [ "EUR", "GBP", "JPY", "CAD", "CHF" ], "mode": "latest", "startDate": "2025-01-01", "endDate": "2025-12-31", "maxResults": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/exchange-rates-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "baseCurrency": "USD", "symbols": [ "EUR", "GBP", "JPY", "CAD", "CHF", ], "mode": "latest", "startDate": "2025-01-01", "endDate": "2025-12-31", "maxResults": 0, } # Run the Actor and wait for it to finish run = client.actor("bovi/exchange-rates-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "baseCurrency": "USD", "symbols": [ "EUR", "GBP", "JPY", "CAD", "CHF" ], "mode": "latest", "startDate": "2025-01-01", "endDate": "2025-12-31", "maxResults": 0 }' | apify call bovi/exchange-rates-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,bovi/exchange-rates-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/a9GfJOB1aJq4uQ12U/builds/uvJo5VO5AUOkONLF1/openapi.json