FX Rates Live — Multi-Currency Quote Table

Fetch near-real-time and historical FX reference rates for multiple currency pairs from the public Frankfurter API (European Central Bank and other official / central-bank sources) into a clean Apify dataset.

This Actor calls https://api.frankfurter.dev only. It does not scrape bank websites, bypass rate limits, or access private data. No API key required.

Important: Rates are official / mid-market reference rates (typically updated once per business day). They are not live trading ticks and are not financial advice.

Features

• Configurable base currency (ISO 4217)
• Multiple quote currencies (or all available quotes)
• Latest snapshot, single historical date, or date-range time series
• Optional provider filter (e.g. ecb for European Central Bank only)
• Optional amount → converted_amount helper
• Optional inverse rate rows (swapped pairs)
• Flat, analysis-ready dataset + OUTPUT_SUMMARY in the key-value store

Input

Field	Type	Description
base	string	Base currency, e.g. USD, EUR, CNY (required)
quotes	string[]	Target currencies; empty = all available for the base
amount	number	Multiply rate → converted_amount (default 1)
date	string	Single day YYYY-MM-DD (empty = latest)
dateFrom / dateTo	string	Historical series bounds (YYYY-MM-DD)
provider	string	`` (blended), ecb, fred, boe, boj, cfets, bis
includeInverse	boolean	Also push quote→base rows
maxItems	integer	Safety cap (1–100000, default 5000)

Example input — latest multi-pair table

{
  "base": "USD",
  "quotes": ["EUR", "GBP", "CNY", "JPY", "HKD", "AUD", "CAD", "CHF"],
  "amount": 1,
  "includeInverse": false,
  "maxItems": 500
}

Example input — ECB EUR series

{
  "base": "EUR",
  "quotes": ["USD", "CNY", "GBP"],
  "provider": "ecb",
  "dateFrom": "2026-09-01",
  "dateTo": "2026-10-09",
  "maxItems": 5000
}

Output

Each dataset item is one rate quote:

date, base, quote, pair, rate, inverse_rate, amount, converted_amount, provider, is_inverse, fetched_at, source, source_url.

A run summary is stored as key-value record OUTPUT_SUMMARY.

Use cases

• E-commerce / SaaS multi-currency price tables
• Accounting, tax, and ERP reference-rate snapshots
• Dashboards and scheduled FX monitoring
• Downstream enrichment for AI / RAG / spreadsheet pipelines

Compliance & attribution

• Data source: Frankfurter aggregating public central-bank / official reference rates (including ECB)
• License & provider terms · API docs
• Software: MIT (Frankfurter). Rates belong to their respective providers; their terms apply.
• For tax, accounting, or legal work, verify figures against the provider’s own publication.
• This Actor retries politely on HTTP 429/5xx.

Pricing (suggested)

Recommended monetization: Pay-per-event (PPE) — rental is sunset for new Actors.

Suggested events:

Event	Suggested FREE-tier price	Notes
apify-actor-start	$0.00005 (platform default)	Covers first seconds of compute
apify-default-dataset-item	$0.0004 – $0.0006 per result	~$0.40–$0.60 per 1,000 rate rows

Offer ~10% off Silver and ~20% off Gold vs FREE. Start near $0.0005 / result; adjust after real usage. Rows are tiny and time-series runs can be large — keep PPE modest.

Changelog

1.0.0

• Initial release: Frankfurter v2 latest / historical / provider-filtered FX quote table