Reference · built on requestCommons signalEconomic & calendar reference

Open Exchange Rates

Live and historical foreign exchange rates blended from multiple providers, served as JSON with an App ID; free plan is hourly, USD base.

About

Open Exchange Rates is a JSON API at openexchangerates.org/api for live and historical foreign exchange rates. Rates are collected from multiple providers, blended algorithmically, and served against a USD base. End-of-day history runs back to 1 January 1999 and is keyed to the UTC day. Every request carries an App ID. A free plan allows up to 1,000 requests a month with hourly updates; paid plans add base-currency changes, time series, and conversion.

An operator on Fibric fetches latest.json or a dated historical file, applies the rate to the amount at hand, and proposes the result for your approval with the timestamp it used.

This is a reference listing. It documents what Fibric would read from Open Exchange Rates and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Current rates through latest.json, with a UNIX timestamp, the base, and a rates object keyed by currency code
  • End-of-day rates for a UTC day through historical/YYYY-MM-DD.json, back to 1 January 1999
  • Daily series for up to one month through time-series.json with start and end dates (Enterprise and Unlimited plans)
  • A converted amount through convert/{value}/{from}/{to}, returning the rate and timestamp used (Unlimited plan)
  • Currency codes and names through currencies.json, with show_inactive and show_alternative flags and no App ID needed
  • Plan name, quota, update frequency, and requests remaining through usage.json, which does not count against your quota

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Re-price foreign price lists on an hourly rate

    Poll latest.json once an hour, compare each non-USD price list against the current rate, and propose an update when the implied margin slips past your threshold. The timestamp used is kept with the proposal.

    With Price List Drift

  • Reconcile marketplace payouts in local currency

    Read the historical file for each payout's UTC value date, convert the payout to USD, and propose the match against the bank deposit with any residual shown.

    With Payout Reconciliation

  • Check a carrier invoice priced in another currency

    Convert the invoice total at the rate for the invoice date and propose approval or dispute when the converted figure departs from the quoted freight.

    With Freight Audit

  • Apply a foreign remittance to the right invoice

    Convert the received amount at the day's rate and propose which open invoices it settles, flagging short-pays that trace to the rate rather than to the customer.

    With Cash Application

Requirements

  • An Open Exchange Rates account and an App ID, 32 hexadecimal characters, created in the account dashboard
  • USD as the base currency on the free plan; changing base needs the Developer plan or above
  • A request budget: the free plan allows 1,000 requests a month, and each day in a time series counts as one request
  • UTC date handling for historical files, which hold the last values published for that UTC day
Authentication
An App ID from an Open Exchange Rates account, passed as the app_id query parameter or in an Authorization: Token header; the free plan issues one.

Limits

  • No websockets, webhooks, or push; each request returns a single response
  • Time series are capped at one month per request and, like conversion, are restricted to higher plans
  • The terms disclaim accuracy and completeness and bar profiting from resale of the data without a licence
  • The free plan updates hourly; 30-minute and 5-minute updates are tied to paid plans

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Open Exchange Rates ↗

Questions and answers

Is there a free plan?
Yes. The free plan allows up to 1,000 requests a month with hourly updates and a USD base. You get an App ID on sign-up. Requests to currencies.json and usage.json do not count against the monthly quota.
Can I change the base currency?
Only on paid plans. The documentation states that changing the base is available to clients of the Developer, Enterprise, and Unlimited plans. Selecting specific symbols and show_alternative work on every plan, including free.
How are historical rates defined?
A historical file holds the last values published for that UTC day, up to 23:59:59 UTC, back to 1 January 1999. A request for today's UTC date returns the same data as latest.json. Timestamps are UNIX seconds in UTC with no daylight saving applied.
Ask about Open Exchange Rates

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.