National Bank of Georgia Exchange Rates API — nbg-exchange-rate

Official National Bank of Georgia (Georgia) daily exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing — not market estimates, but the numbers National Bank of Georgia itself prints, every business day.

🚀 Why this client?

• 🏛️ Official rates — National Bank of Georgia's own table, with the publisher's own rate_date on every response
• 📅 History back to 2016 — point-in-time tables and daily series for any past date
• 🔀 Official vs derived, always flagged — computed inverse/cross pairs carry derived: true, never mixed with official prints
• ⚡ Zero dependencies — pure ESM + CJS over global fetch; Node 18+, Bun, Deno, and edge runtimes
• 🔷 Type-safe — full TypeScript definitions shipped with the package
• 🧾 Compliance-grade metadata — rate_type, publication date, and source disclaimer on every response

Official rate, not mid-market: every value here is a number National Bank of Georgia itself published, fixed once printed and carrying the central bank's own rate_date — what filings and audits require. Need the live mid-market rate for pricing or display instead? Use the mid-market API or @allratestoday/sdk. The two can diverge by several percent.

🔑 Get your API key

Get a free API key at allratestoday.com/register — no credit card required. Latest rates are on every plan, including free.

📈 Latest official table

The image is rendered live from the keyless endpoint, so it follows the central bank's publications on npm and on GitHub alike without a new release. The same table as text is folded below for search and copy-paste: on GitHub a daily Action refreshes it whenever the central bank publishes a new table; on npm it is as of the package's publish date.

Base	Quote	Type	Rate
AED	GEL	reference	0.70604
AMD	GEL	reference	0.0071944
AUD	GEL	reference	1.7816
AZN	GEL	reference	1.5257
BRL	GEL	reference	0.4642
BYN	GEL	reference	0.8631
CAD	GEL	reference	1.8236
CHF	GEL	reference	3.1282
CNY	GEL	reference	0.38881
CZK	GEL	reference	0.11855
DKK	GEL	reference	0.38653
EGP	GEL	reference	0.04847
EUR	GEL	reference	2.8895
GBP	GEL	reference	3.4551
HKD	GEL	reference	0.33055
HUF	GEL	reference	0.007912
ILS	GEL	reference	0.81643
INR	GEL	reference	0.027679
IRR	GEL	reference	0.00000136
ISK	GEL	reference	0.021122
JPY	GEL	reference	0.016312
KGS	GEL	reference	0.029654

Source: Official rates published by NBG, served by AllRatesToday. Rates are as printed by the central bank; AllRatesToday is not affiliated with it.

📦 Installation

npm install nbg-exchange-rate

yarn add nbg-exchange-rate

pnpm add nbg-exchange-rate

Requires Node 18+ (global fetch); also runs on Bun, Deno and edge runtimes. Also published under the org scope as @allratestoday/nbg-exchange-rate — same code, same versions.

🏁 Quick start

import { getRate } from 'nbg-exchange-rate';

const pair = await getRate('USD', 'GEL', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); // the official National Bank of Georgia rate, on the central bank's own date

This is the beginning of the README. Read the rest at the original. Read the full README ↗