National Bank of Ukraine Exchange Rate API: Official UAH Rates as JSON

The National Bank of Ukraine sets the hryvnia's official exchange rates for around 45 currencies each business day — published in the afternoon for the next working day — and these are the published official rates Ukrainian accounting and customs law mandate, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency nbu-exchange-rate npm package, with history back to September 1996.

What the NBU publishes

• ~45 currencies against the hryvnia — USD, EUR, GBP, PLN, CNY, plus gold and other precious metals.
• History back to September 1996 — the full hryvnia era, 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 — requests for weekends and Ukrainian holidays resolve to the most recent published rates and are flagged explicitly.

The USD/UAH official rate is the anchor of the table: the NBU sets it each afternoon for the next working day, and Ukrainian accounting, customs valuation, and contract law reference it directly.

Why official rates, not market rates

A live mid-market feed answers "what is USD/UAH 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's published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/bok/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 nbu-exchange-rate

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

// One pair at the official NBU rate
const pair = await getRate('USD', 'UAH', { 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 'nbu-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: 'UAH', 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 NBU does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross rate via UAH — 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.

The full hryvnia era, 1996 to today

The series starts on 2 September 1996 — the day the hryvnia replaced the karbovanets at 1.761 per dollar. From there the official record traces the 1998 crisis, the managed pegs of the 2000s, the 2014–2015 devaluation after Crimea, the wartime fixed rate of 2022, and the managed flexibility that followed. For invoice-date lookups, audits, and research, it is the definitive official record of the hryvnia.

FAQ

Does the National Bank of Ukraine have an official exchange rate API?

Yes — the NBU has one of the friendliest open APIs of any central bank, and AllRatesToday serves the same official rates in the unified multi-bank format used by 33 other central banks: around 45 currencies against the hryvnia, history back to 1996, via REST or the nbu-exchange-rate npm package. The latest table is free.

How often do National Bank of Ukraine rates update?

Once per business day — the NBU sets the official rate in the afternoon for the next working day. These are published reference rates, not moving market prices — every API response carries the bank's own publication date so you can cite it.

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

Yes. The /central-bank/nbu/rates-for-date endpoint returns the official rates for any date back to September 1996. 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.