# National Bank of Georgia API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nbg-api/..."
```

## Pricing
- **Free** (Free) — 12,000 calls/Mo, 3 req/s
- **Basic** ($7/Mo) — 165,000 calls/Mo, 8 req/s
- **Pro** ($20/Mo) — 1,020,000 calls/Mo, 15 req/s
- **Scale** ($51/Mo) — 5,400,000 calls/Mo, 35 req/s

## Endpoints

### Rates

#### `GET /v1/rate` — One currency lari-per-unit rate, inverse and daily change

**Parameters:**
- `currency` (query, required, string) — 3-letter ISO currency code Example: `USD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nbg-api/v1/rate?currency=USD"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/rates` — NBG official rate for every currency vs the lari

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nbg-api/v1/rates"
```

**Response:**
```json
{
    "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,
       
…(truncated, see openapi.json for full schema)
```

### History

#### `GET /v1/history` — A currency official rate on a specific past date

**Parameters:**
- `currency` (query, required, string) — 3-letter ISO currency code Example: `USD`
- `date` (query, required, string) — Date YYYY-MM-DD Example: `2026-05-15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nbg-api/v1/history?currency=USD&date=2026-05-15"
```

**Response:**
```json
{
    "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
}
```

### Convert

#### `GET /v1/convert` — Convert an amount between two currencies at NBG rates

**Parameters:**
- `from` (query, required, string) — Source currency Example: `USD`
- `to` (query, required, string) — Target currency Example: `EUR`
- `amount` (query, optional, string) — Amount to convert Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nbg-api/v1/convert?from=USD&to=EUR&amount=100"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nbg-api/v1/meta"
```

**Response:**
```json
{
    "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, C
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/nbg-api
OpenAPI spec: https://www.oanor.com/api/nbg-api/openapi.json