Currency Exchange Rates API: Open Exchange Rates
Pricing
from $5.00 / 1,000 exchange rate for one currency and dates
Currency Exchange Rates API: Open Exchange Rates
Currency exchange rates API for 200+ currencies: latest FX rates, historical exchange rates back to 1999, monthly time series, OHLC and average rates, currency conversion and the currency list, through the Open Exchange Rates API. Bring your own key.
Pricing
from $5.00 / 1,000 exchange rate for one currency and dates
Rating
0.0
(0)
Developer
Nabeel Hassan
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
21 days ago
Last modified
Categories
Features
Share
Get latest and historical currency exchange rates for 200+ currencies, daily FX time series, OHLC and average rates and currency conversions from Open Exchange Rates with your own App ID, as clean rows you can export to CSV, Excel or JSON.
Open Exchange Rates (Open Exchange Rates (UK) Ltd) is a foreign exchange rate data service used by startups, ecommerce stores, accounting tools and finance teams. This actor wraps the read endpoints of the Open Exchange Rates API: latest rates, historical rates back to 1 January 1999, the time series and OHLC endpoints, the convert endpoint, the currency list and your App ID's usage. Use it for multi currency pricing, invoice and accounting conversions, treasury and FX reporting, BI pipelines, spreadsheets and backtesting. Bring your own API key.
BYOK, not live tested: every route, parameter and response field comes from Open Exchange Rates' own API documentation (docs.openexchangerates.org), and every route was probed on 2026-11-01 with an invalid App ID. The actor has not been run against a live App ID.
What it does
- Latest exchange rates: the most recent rates available on your plan (the usage mode shows its update frequency) for every currency, or just the codes you list, against USD or another base.
- Historical exchange rates: end of day rates (the last values published each UTC day) for any list of dates or a whole date range, back to 1999-01-01.
- Exchange rate time series: daily rates over a range, requested one calendar month at a time as the API requires (Enterprise and Unlimited plans).
- OHLC and average rates: open, high, low, close and time weighted average rates for periods from 1 minute to 1 month (VIP Platinum plan).
- Currency conversion: convert any amount between two currencies at the latest rate (Unlimited plan).
- Currency list: every currency code with its full name, optionally with alternative, digital and inactive currencies. Needs no key and is free.
- Usage and plan: your plan name, update frequency, enabled features and requests used and remaining this month. Free.
- Two row layouts for rate modes: one flat row per currency and date with rate and inverse rate, or one row per date holding every rate.
- Plan aware: features your plan lacks end the run cleanly with a message naming the plan that has them, and a historical request whose symbols filter your plan refuses is retried without it and filtered by the actor.
- Read only and pay only for results: empty answers and refused lookups become a free row that says why.
How to get your own key
- Sign up at openexchangerates.org/signup. The free plan covers latest and historical rates with USD as base; paid plans add base currency changes, time series, OHLC and conversion.
- Copy your App ID from openexchangerates.org/account/app-ids.
- Paste it into the Open Exchange Rates App ID field, or set the DATA_API_KEY environment secret. The actor sends it in the documented
Authorization: Tokenheader. - Run the Usage and plan mode first to see which features your App ID includes.
Input
| Field | Modes | Notes |
|---|---|---|
mode | all | latest, historical, timeSeries, ohlc, convert, currencies, usage |
apiKey | all but currencies | your App ID; falls back to the DATA_API_KEY secret |
base | rate modes, ohlc | 3 letter base code, default USD (other bases need a paid plan) |
symbols | rate modes, ohlc | codes to return, such as EUR, GBP, JPY; empty for all |
showAlternative | rate modes, ohlc, currencies | add alternative and digital currencies |
dates | historical | one YYYY-MM-DD per line, from 1999-01-01 |
startDate, endDate | historical, timeSeries | inclusive range; historical reads every day (up to 1,000), the time series one month per request |
startTimes | ohlc | one YYYY-MM-DDThh:mm:00Z per line, on or after 2016-12-19 |
period | ohlc | 1m, 5m, 15m, 30m, 1h, 12h, 1d, 1w, 1mo |
conversions | convert | one amount FROM TO per line, such as 100 GBP EUR |
showInactive | currencies | add inactive currencies |
rowLayout | rate modes | pairs (one row per currency and date) or snapshots (one row per date) |
maxResults | all | stop after this many rows (default 1,000) |
Output
A rate row in the pairs layout:
{"mode": "historical","recordType": "rate","query": "2024-01-31","found": true,"date": "2024-01-31","timestamp": 1706745599,"publishedAt": "2024-01-31T23:59:59.000Z","base": "USD","currency": "EUR","currencyName": "Euro","rate": 0.924712,"inverseRate": 1.0814178857}
An OHLC row:
{"mode": "ohlc","recordType": "ohlc","query": "2024-01-02T00:00:00Z 1d","found": true,"startTime": "2024-01-02T00:00:00Z","endTime": "2024-01-02T23:59:59Z","period": "1d","base": "USD","currency": "GBP","currencyName": "British Pound Sterling","open": 0.78566,"high": 0.79265,"low": 0.78453,"close": 0.79171,"average": 0.78897}
Snapshot rows carry date, base, currencyCount and a rates object; conversion rows carry from, to, amount, rate, converted and publishedAt; currency rows carry currency and currencyName; the usage row carries planName, quota, updateFrequency, features, requests, requestsQuota and requestsRemaining (the App ID itself is never written). The values above are illustrative.
Pricing
Pay per event, only for rows with data:
| Event | Price |
|---|---|
| Exchange rate (one currency and date, pairs layout) | $0.005 |
| Rate snapshot (one date with every requested rate) | $0.02 |
| OHLC bar (one currency and period) | $0.01 |
| Currency conversion | $0.005 |
| Currency list and usage rows | free |
Your Open Exchange Rates plan is billed separately by Open Exchange Rates. Each historical date and each time series day counts as one request against your monthly allowance; the currency list and usage calls do not count. With many currencies, the snapshots layout or a short symbols list keeps the cost down.
FAQ
What is the Open Exchange Rates API?
The Open Exchange Rates API is a JSON foreign exchange rate API run by Open Exchange Rates (UK) Ltd. It publishes midpoint exchange rates for 200+ world, alternative and digital currencies, with latest, historical (from 1999), time series, OHLC and conversion endpoints.
Do I need my own Open Exchange Rates App ID?
Yes for every mode except the currency list. This actor is bring your own key: your App ID, your plan and your monthly request allowance. A free App ID covers latest and historical rates against USD.
Why did my run stop with "not on your plan"?
Open Exchange Rates gates some features by plan: changing the base currency needs a paid plan, symbols on historical rates need the Developer plan or above, the time series needs Enterprise or Unlimited, convert needs Unlimited and OHLC needs VIP Platinum. The run ends cleanly and says which plan has the feature. The usage and plan mode shows your features.
How far back do historical exchange rates go?
To 1 January 1999. Each date returns the last rates published that UTC day; a request for today's UTC date returns the latest rates instead.
Are these mid market rates?
Yes. The Open Exchange Rates documentation describes its values as midpoint rates. They are reference rates for information, not dealing quotes, and Open Exchange Rates gives no warranty for transactional use.
How is this different from other exchange rate actors?
It calls the official Open Exchange Rates API with your own App ID, so you get the provider's own data under your own plan, every documented read endpoint, plan aware error handling and flat rows with inverse rates and currency names.
What do I pay?
$0.005 per exchange rate row or conversion, $0.01 per OHLC bar and $0.02 per one row per date snapshot. The currency list, the usage row, empty answers and refused lookups are free.
Keyword map
currency exchange rates API, historical exchange rates, FX rates API, foreign exchange rates, exchange rate time series, OHLC exchange rates, currency converter API, Open Exchange Rates, openexchangerates.org, USD EUR GBP JPY rates, currency list, forex data.
Routes and verification
| Mode | Route | Probe with invalid App ID (twice) |
|---|---|---|
| Latest rates | GET /api/latest.json | 401 JSON invalid_app_id (query and Authorization header) |
| Historical rates | GET /api/historical/{date}.json | 401 JSON invalid_app_id |
| Time series | GET /api/time-series.json | 401 JSON invalid_app_id |
| OHLC | GET /api/ohlc.json | 401 JSON invalid_app_id |
| Convert | GET /api/convert/{value}/{from}/{to} | 401 JSON invalid_app_id |
| Usage | GET /api/usage.json | 401 JSON invalid_app_id |
| Currency list | GET /api/currencies.json | 200 JSON without a key, as documented |
| Invented control routes | GET /api/spot-rates.json, /api/historical-range.json | 405 text/plain Method Not Allowed |
Every keyed request sends the App ID in the documented Authorization: Token header, never in a URL or a log line. The currency list is called without the key.
Licensing and data use
This actor works only with your own Open Exchange Rates App ID, and your agreement with Open Exchange Rates applies: the Terms and Conditions of Website Use, the Acceptable Use Policy and, for paid plans, the Services Agreement. The Services Agreement licenses the data for reasonable use under those terms and sets no cache or retention limit. The terms say you must not profit directly from selling or providing the information or resell access without a licence from Open Exchange Rates, ask you to keep your App ID confidential, and state that consumer (non business) users get the site for domestic and private use only. Use the rates in your own products and reporting and do not resell the raw data. This actor is not affiliated with or endorsed by Open Exchange Rates.