FX Rates: Official ECB Rates + CFA Franc & Gulf Pegs
Pricing
Pay per event
FX Rates: Official ECB Rates + CFA Franc & Gulf Pegs
Convert currencies with official European Central Bank reference rates (daily since 1999), plus CFA franc (XOF/XAF), AED, SAR, QAR and other official pegs. Historical rates, time series, rate tables. Built for AI agents and invoicing. Pay per call.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Novarithm
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 hours ago
Last modified
Categories
Share
FX Rates API: Official ECB Exchange Rates + CFA Franc & Gulf Pegs
Convert currencies with the official European Central Bank (ECB) reference rates, daily since 1999, plus the officially pegged currencies the ECB does not publish:
- CFA francs XOF (BCEAO) and XAF (BEAC), Comorian franc KMF, Cape Verde escudo CVE (fixed to the euro)
- UAE dirham AED, Saudi riyal SAR, Qatari riyal QAR, Bahraini dinar BHD, Omani rial OMR (fixed to the US dollar)
Every answer states the rate date, the method (direct ECB rate, cross rate via EUR, or peg-derived) and the source, so an AI agent or an accountant can justify the number.
Three operations
| Operation | What you get |
|---|---|
| Conversion | Amount converted between two currencies, today or at any date since 1999 (weekends/holidays fall back to the last ECB business day, with a note). |
| Time series | Daily rates for a pair over up to 366 days, with min, max, mean and % change. |
| Rate table | All official rates for a base currency on the latest (or a given) ECB fixing date. |
Use cases
- An AI invoicing or bookkeeping agent converts a USD invoice to EUR at the official rate of the invoice date.
- An e-commerce site in West Africa shows prices in XOF from EUR or USD.
- A Dubai trading desk converts AED quotes to EUR or GBP.
- A treasury report needs the GBP/USD trend for last quarter.
Input
| Field | Example |
|---|---|
conversions | [{"from": "USD", "to": "EUR", "amount": 1250}, {"from": "EUR", "to": "XOF", "amount": 100, "date": "2025-12-31"}] |
timeseries | [{"from": "GBP", "to": "USD", "start": "2026-01-01", "end": "2026-03-31"}] |
rateTables | [{"base": "USD", "symbols": "EUR,GBP,AED,XOF,JPY"}] (empty symbols = all currencies) |
queries | Advanced: [{"endpoint": "fx_convert", "params": {"from": "AED", "to": "EUR", "amount": 50000}}]; endpoints fx_convert, fx_timeseries, fx_latest |
maxQueries | Safety cap on calls per run (default 1000). |
Output
One dataset item per call. Shortened examples from a real run:
{"endpoint": "fx_convert","input": {"from": "EUR", "to": "XOF", "amount": 100},"ok": true,"result": {"from": "EUR", "to": "XOF", "amount": 100,"rate": 655.957, "converted": 65595.7,"rate_date": "2026-10-22","method": "peg_derived","pegs": ["BCEAO — franc CFA UEMOA (parité fixe garantie par le Trésor français)"],"explanation": "1 EUR = 655.957000 XOF (ECB reference rate of 2026-10-22, via official peg)"},"charged_event": "fx-convert","price_usd": 0.002}
USD → EUR, 1250→converted: 1115.57,method: "ecb_direct".GBP/USD, Q1 2026→ 63 daily points with min/max/mean/change %.- Rate table, base USD → EUR, AED (3.6725, peg), XOF...
Pricing (pay per event)
| Event | Price |
|---|---|
| Conversion | $0.002 |
| Rate table | $0.002 |
| Time series (up to 366 days) | $0.005 |
No start fee. Not charged: unsupported currencies, invalid dates or parameters, future dates, source outages and internal errors (the item says "ok": false and why).
Honest limits
- Not real-time: ECB reference rates are published once a day around 16:00 CET on TARGET business days. No intraday or market rates.
- ECB rates are published for information purposes: they are not the rate your bank will apply to a transaction.
- Currencies outside the ECB list and outside official pegs (e.g. NGN, KES, MAD, EGP) are not covered and are answered with
unsupported_currency(not charged).
Data sources
- ECB euro foreign exchange reference rates, free reuse with source acknowledgement. Downloaded live at each run.
- Official fixed parities set by treaty or central banks (BCEAO, BEAC, Banque Centrale des Comores, Banco de Cabo Verde, CBUAE, SAMA, QCB, CBB, CBO).
Made by Novarithm, AI agents and automation. Contact: contact@novarithm.com
Want this whole store under your brand? → https://gogeta2-u35175.vm.elestio.app/agents/clones/en/cases/api-store-for-ai-agents/