{"openapi":"3.1.0","info":{"title":"National Bank of Georgia API","version":"1.0.0","description":"Live official exchange-rate data from the National Bank of Georgia (NBG), the central bank of Georgia, for the lari (GEL) — uniquely including each rate's daily change: the NBG official rate for every published currency (normalised to one unit) with the day's change, a single currency's lari-per-unit rate and inverse plus daily change, a currency's official rate on a specific past date, and currency conversion between any two published currencies (including GEL) cross-computed through the lari at NBG rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbg-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"History"},{"name":"Convert"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/rate":{"get":{"operationId":"get_v1_rate","tags":["Rates"],"summary":"One currency lari-per-unit rate, inverse and daily change","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"GEL","date":"2026-06-11","name":"US Dollar","source":"National Bank of Georgia","currency":"USD","quantity":1,"daily_change":-0.0014,"gel_per_unit":2.6593,"unit_per_gel":0.37603881},"meta":{"timestamp":"2026-06-10T14:01:36.600Z","request_id":"440a93f7-34c5-48fc-9c6e-2fa6e20331d5"},"status":"ok","message":"Rate retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"NBG official rate for every currency vs the lari","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"GEL","date":"2026-06-11","count":42,"rates":[{"date":"2026-06-11","name":"United Arab Emirates Dirhams","currency":"AED","quantity":10,"daily_change":-0.0036,"gel_per_unit":0.72401,"rate_per_quantity":7.2401},{"date":"2026-06-11","name":"Armenian Dram","currency":"AMD","quantity":1000,"daily_change":-0.0003,"gel_per_unit":0.007214,"rate_per_quantity":7.214},{"date":"2026-06-11","name":"Australian Dollar","currency":"AUD","quantity":1,"daily_change":-0.0135,"gel_per_unit":1.8642,"rate_per_quantity":1.8642},{"date":"2026-06-11","name":"Azerbaijan Manat","currency":"AZN","quantity":1,"daily_change":-0.0005,"gel_per_unit":1.5646,"rate_per_quantity":1.5646},{"date":"2026-06-11","name":"Brazilian Real","currency":"BRL","quantity":1,"daily_change":0.0018,"gel_per_unit":0.5141,"rate_per_quantity":0.5141},{"date":"2026-06-11","name":"Belarusian Rouble","currency":"BYN","quantity":1,"daily_change":0.0014,"gel_per_unit":0.9674,"rate_per_quantity":0.9674},{"date":"2026-06-11","name":"Canadian Dollar","currency":"CAD","quantity":1,"daily_change":-0.0005,"gel_per_unit":1.9093,"rate_per_quantity":1.9093},{"date":"2026-06-11","name":"Swiss Franc","currency":"CHF","quantity":1,"daily_change":-0.0113,"gel_per_unit":3.3304,"rate_per_quantity":3.3304},{"date":"2026-06-11","name":"China Renminbi","currency":"CNY","quantity":10,"daily_change":-0.0061,"gel_per_unit":0.3923,"rate_per_quantity":3.923},{"date":"2026-06-11","name":"Czech Koruna","currency":"CZK","quantity":10,"daily_change":-0.0027,"gel_per_unit":0.12702,"rate_per_quantity":1.2702},{"date":"2026-06-11","name":"Danish Krone","currency":"DKK","quantity":10,"daily_change":-0.0077,"gel_per_unit":0.41103,"rate_per_quantity":4.1103},{"date":"2026-06-11","name":"Egyptian Pound","currency":"EGP","quantity":10,"daily_change":-0.0012,"gel_per_unit":0.05132,"rate_per_quantity":0.5132},{"date":"2026-06-11","name":"Euro","currency":"EUR","quantity":1,"daily_change":-0.0056,"gel_per_unit":3.0723,"rate_per_quantity":3.0723},{"date":"2026-06-11","name":"United Kingdom Pound","currency":"GBP","quantity":1,"daily_change":-0.0024,"gel_per_unit":3.5619,"rate_per_quantity":3.5619},{"date":"2026-06-11","name":"Hong-Kong Dollar","currency":"HKD","quantity":10,"daily_change":-0.0017,"gel_per_unit":0.33933,"rate_per_quantity":3.3933},{"date":"2026-06-11","name":"Hungarian Forint","currency":"HUF","quantity":100,"daily_change":-0.0029,"gel_per_unit":0.008636,"rate_per_quantity":0.8636},{"date":"2026-06-11","name":"Israeli Shekel","currency":"ILS","quantity":10,"daily_change":-0.1167,"gel_per_unit":0.89364,"rate_per_quantity":8.9364},{"date":"2026-06-11","name":"Indian Rupee","currency":"INR","quantity":100,"daily_change":0.0009,"gel_per_unit":0.027913,"rate_per_quantity":2.7913},{"date":"2026-06-11","name":"Iranian Rial","currency":"IRR","quantity":10000,"daily_change":-0.0001,"gel_per_unit":1.93e-6,"rate_per_quantity":0.0193},{"date":"2026-06-11","name":"Iceland Krona","currency":"ISK","quantity":100,"daily_change":-0.0009,"gel_per_unit":0.021424,"rate_per_quantity":2.1424},{"date":"2026-06-11","name":"Japanese Yen","currency":"JPY","quantity":100,"daily_change":-0.0041,"gel_per_unit":0.016572,"rate_per_quantity":1.6572},{"date":"2026-06-11","name":"Kyrgyzstan Som","currency":"KGS","quantity":100,"daily_change":-0.0019,"gel_per_unit":0.030404,"rate_per_quantity":3.0404},{"date":"2026-06-11","name":"South Korean Won","currency":"KRW","quantity":1000,"daily_change":0.0004,"gel_per_unit":0.0017474,"rate_per_quantity":1.7474},{"date":"2026-06-11","name":"Kuwaiti Dinar","currency":"KWD","quantity":1,"daily_change":-0.0073,"gel_per_unit":8.6006,"rate_per_quantity":8.6006},{"date":"2026-06-11","name":"Kazakhstan Tenge","currency":"KZT","quantity":100,"daily_change":-0.0004,"gel_per_unit":0.005449,"rate_per_quantity":0.5449},{"date":"2026-06-11","name":"Moldova Lei","currency":"MDL","quantity":10,"daily_change":0.0005,"gel_per_unit":0.15301,"rate_per_quantity":1.5301},{"date":"2026-06-11","name":"Norwegian Krone","currency":"NOK","quantity":10,"daily_change":-0.0137,"gel_per_unit":0.27996,"rate_per_quantity":2.7996},{"date":"2026-06-11","name":"New Zealand Dollar","currency":"NZD","quantity":1,"daily_change":-0.0067,"gel_per_unit":1.5456,"rate_per_quantity":1.5456},{"date":"2026-06-11","name":"Polish Zloty","currency":"PLN","quantity":10,"daily_change":-0.0281,"gel_per_unit":0.72354,"rate_per_quantity":7.2354},{"date":"2026-06-11","name":"Qatari Rial","currency":"QAR","quantity":10,"daily_change":-0.0043,"gel_per_unit":0.72937,"rate_per_quantity":7.2937},{"date":"2026-06-11","name":"Romanian Leu","currency":"RON","quantity":10,"daily_change":-0.0092,"gel_per_unit":0.58665,"rate_per_quantity":5.8665},{"date":"2026-06-11","name":"Serbian Dinar","currency":"RSD","quantity":100,"daily_change":-0.0037,"gel_per_unit":0.026177,"rate_per_quantity":2.6177},{"date":"2026-06-11","name":"Russian Ruble","currency":"RUB","quantity":100,"daily_change":-0.0141,"gel_per_unit":0.036969,"rate_per_quantity":3.6969},{"date":"2026-06-11","name":"Swedish Krona","currency":"SEK","quantity":10,"daily_change":-0.0239,"gel_per_unit":0.28014,"rate_per_quantity":2.8014},{"date":"2026-06-11","name":"Singapore Dollar","currency":"SGD","quantity":1,"daily_change":-0.0043,"gel_per_unit":2.0653,"rate_per_quantity":2.0653},{"date":"2026-06-11","name":"Tajikistan Somoni","currency":"TJS","quantity":10,"daily_change":-0.0013,"gel_per_unit":0.28529,"rate_per_quantity":2.8529},{"date":"2026-06-11","name":"Turkmenistan Manat","currency":"TMT","quantity":10,"daily_change":-0.004,"gel_per_unit":0.7598,"rate_per_quantity":7.598},{"date":"2026-06-11","name":"Turkish Lira","currency":"TRY","quantity":1,"daily_change":-0.0001,"gel_per_unit":0.0576,"rate_per_quantity":0.0576},{"date":"2026-06-11","name":"Ukraine Hryvna","currency":"UAH","quantity":10,"daily_change":-0.0018,"gel_per_unit":0.0591,"rate_per_quantity":0.591},{"date":"2026-06-11","name":"US Dollar","currency":"USD","quantity":1,"daily_change":-0.0014,"gel_per_unit":2.6593,"rate_per_quantity":2.6593},{"date":"2026-06-11","name":"Uzbekistan Sum","currency":"UZS","quantity":1000,"daily_change":-0.0005,"gel_per_unit":0.0002207,"rate_per_quantity":0.2207},{"date":"2026-06-11","name":"South African Rand","currency":"ZAR","quantity":10,"daily_change":-0.0116,"gel_per_unit":0.16058,"rate_per_quantity":1.6058}],"source":"National Bank of Georgia"},"meta":{"timestamp":"2026-06-10T14:01:36.809Z","request_id":"3f5fe52d-784c-4775-9a7e-f7067147c3ec"},"status":"ok","message":"Rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"A currency official rate on a specific past date","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"GEL","date":"2026-05-15","name":"US Dollar","source":"National Bank of Georgia","currency":"USD","quantity":1,"daily_change":-0.0016,"gel_per_unit":2.6802,"unit_per_gel":0.37310648},"meta":{"timestamp":"2026-06-10T14:01:37.085Z","request_id":"9dd49d41-10b0-4526-b403-c8df90a988e6"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies at NBG rates","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","date":"2026-06-11","from":"USD","rate":0.86557302,"amount":100,"result":86.557302,"source":"National Bank of Georgia","gel_per_to":3.0723,"gel_per_from":2.6593},"meta":{"timestamp":"2026-06-10T14:01:37.519Z","request_id":"4d46a92c-7f51-4761-bd75-3c50306847bf"},"status":"ok","message":"Conversion completed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"National Bank of Georgia API (nbg.gov.ge, live)","service":"nbg-api","usd_gel":2.6593,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, lari-per-unit and inverse, plus daily change (currency=USD).","GET /v1/rates":"The NBG official rate for every currency vs the lari, with daily change.","GET /v1/convert":"Convert an amount between two currencies at NBG rates (from=USD, to=EUR, amount=100).","GET /v1/history":"A currency's official rate on a specific past date (currency=USD, date=2026-05-15)."},"description":"Live official exchange-rate data from the National Bank of Georgia (NBG), the central bank of Georgia, for the lari (GEL), via its public API — uniquely including each rate's daily change. The rates endpoint returns the NBG's official rate for every published currency against the lari, normalised to one unit, with the day's change; the rate endpoint returns a single currency's official rate (lari-per-unit and the inverse) plus the daily change; the history endpoint returns a currency's official rate on a specific past date; the convert endpoint converts an amount between any two published currencies (including GEL) at the NBG's official rates, cross-computed through the lari. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR, Riksbank, NBU and HNB feeds and from market mid-rates — this is the National Bank of Georgia's own official lari exchange rate with daily change.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:38.049Z","request_id":"bb08d25d-40d0-48b0-a570-4cb0354e6fab"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":165000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":1020000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5100,"monthly_call_quota":5400000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbg-api"}