Central Bank of Oman Exchange Rate API: Official OMR Rates as JSON

The Central Bank of Oman publishes the official exchange rates that accounting, tax, and customs rules in Oman reference — published official rates, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency cbo-exchange-rate npm package.

What the CBO publishes

• 48 currencies against the rial, buying and selling, from the majors to the remittance corridors Oman actually runs on — BDT, INR, PKR, LKR, PHP, EGP, KES and more.
• Gold, silver, platinum and the SDR (XAU, XAG, XPT, XDR) in the same table, priced in rials.
• History since 2022, every published business day, queryable by exact date or as a time series.
• The bank’s own publication date on every response, so a rate is always citable.
• No gaps to trip over — the Friday-Saturday Omani weekend and public holidays resolve to the most recent published table and are flagged explicitly.

The rial has been pegged to the US dollar since 1986 and CBO quotes it at 0.384/0.385 without variation, so the dollar line is not where the value is. The breadth is: this is one of the few official Gulf tables that prices the taka, the rupee and the peso, which is exactly what an Omani importer, a customs entry or a remittance reconciliation needs and cannot get from a dollar-only source.

Why official rates, not market rates

A live mid-market feed answers "what is USD/OMR trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you required to use for this date?" That answer comes from the Central Bank of Oman's published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/cbo/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is the bank's most recent published data — every rate and the publication date. The latest rates are available on every plan, including the free tier (300 requests/month, no credit card).

The npm SDK

npm install cbo-exchange-rate

import { getRate, getLatestRates } from 'cbo-exchange-rate';

// One pair at the official CBO rate
const pair = await getRate('USD', 'OMR', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.

Historical rates for an invoice date

import { getRatesForDate, getHistory } from 'cbo-exchange-rate';

// The official rates for an invoice date — non-publication days return
// the most recent published date, flagged via published_on_requested_date.
const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });

// Time series for one pair
const series = await getHistory(
  { source: 'USD', target: 'OMR', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);

Historical dates and time series need a paid plan; the latest rates stay free.

Published vs derived pairs

If the CBO does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross rate via OMR — and flags it derived: true with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

A short archive, published daily

CBO’s searchable archive begins in 2022, and we hold every business day it has published since. That is younger than most of our sources, and it is what the bank itself makes available — there is no deeper public series to load. For the dollar leg it hardly matters, since the peg has held at 0.3845 since 1986; for the taka, rupee and rand lines, which move daily, the archive is the record.

FAQ

Does the Central Bank of Oman have an official exchange rate API?

The CBO publishes its official rates on its own site, and AllRatesToday serves the same published rates as clean JSON via REST or the cbo-exchange-rate npm package. The latest table is free.

How often do Central Bank of Oman rates update?

Once per business day, posted around 10:00 Muscat time. Oman’s week runs Sunday to Thursday, so Friday and Saturday carry no new table. CBO labels the rates "indications", and we serve them with the bank’s own publication date so you can cite them.

Can I get the CBO rate for a past date, like an invoice date?

Yes. The /central-bank/cbo/rates-for-date endpoint returns the official rates for any archived date. Non-publication days resolve to the most recent published date and are flagged, so your audit trail stays honest. Historical dates require a paid plan; latest rates are free.