# NBKR Kyrgyzstan FX API
> Live official foreign-exchange reference rates from the National Bank of the Kyrgyz Republic (NBKR), read straight from the bank's published fixing — no key on the data, nothing cached, nothing stored. Get every currency the NBKR fixes against the Kyrgyzstani som (KGS) for the day, each normalized to a clean per-unit rate; look one currency up on its own; pull the separate weekly accounting rates (valid for seven days); or convert any amount between two listed currencies by crossing through the som. The som is the base and rates carry the NBKR fixing date. This is the Kyrgyzstan national-central-bank feed specifically — a distinct official source, separate from the other FX, central-bank and market APIs in the catalogue, so treasury, invoicing, payroll and accounting workflows that need the legally-referenced KGS rate can read it directly.

## 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/nbkr-api/..."
```

## Pricing
- **Free** (Free) — 25,000 calls/Mo, 3 req/s
- **Starter** ($6/Mo) — 320,000 calls/Mo, 10 req/s
- **Growth** ($19/Mo) — 1,350,000 calls/Mo, 25 req/s
- **Scale** ($44/Mo) — 4,900,000 calls/Mo, 50 req/s

## Endpoints

### Rates

#### `GET /v1/rates` — All daily KGS reference rates

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

**Response:**
```json
{
    "data": {
        "base": "KGS",
        "date": "11.06.2026",
        "count": 5,
        "rates": [
            {
                "code": "CNY",
                "value": 12.9016,
                "nominal": 1,
                "per_unit": 12.9016
            },
            {
                "code": "EUR",
                "value": 101.0387,
                "nominal": 1,
                "per_unit": 101.0387
            },
            {
                "code": "KZT",
                "value": 0.1789,
                "nominal": 1,
                "per_unit": 0.1789
            },
            {
                "code": "RUB",
                "value": 1.218,
                "nominal": 1,
                "per_unit": 1.218
            },
            {
                "code": "USD",
                "value": 87.4491,
                "nominal": 1,
                "per_unit": 87.4491
            }
        ],
        "source": "NBKR"
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:52.566Z",
        "request_id": "8c76544e-6b06-4d95-bcfe-f2538b5422dd"
    },
    "status": "ok",
    "message": "Rates retrieved successfully",
    "success": true
}
```

### Rate

#### `GET /v1/rate` — One currency's daily rate

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

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

**Response:**
```json
{
    "data": {
        "base": "KGS",
        "code": "USD",
        "date": "11.06.2026",
        "value": 87.4491,
        "source": "NBKR",
        "nominal": 1,
        "per_unit": 87.4491
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:52.730Z",
        "request_id": "57663bb3-3d06-462e-bcf3-9b567284fb43"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Weekly

#### `GET /v1/weekly` — Weekly accounting rates (valid seven days)

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

**Response:**
```json
{
    "data": {
        "base": "KGS",
        "count": 40,
        "rates": [
            {
                "code": "AED",
                "value": 23.8108,
                "nominal": 1,
                "per_unit": 23.8108,
                "valid_for_days": 7
            },
            {
                "code": "AFN",
                "value": 1.3709,
                "nominal": 1,
                "per_unit": 1.3709,
                "valid_for_days": 7
            },
            {
                "code": "AMD",
                "value": 2.3726,
                "nominal": 10,
                "per_unit": 0.23726,
                "valid_for_days": 7
            },
            {
                "code": "AUD",
                "value": 62.3562,
                "nominal": 1,
                "per_unit": 62.3562,
                "valid_for_days": 7
            },
            {
                "code": "AZN",
                "value": 51.4412,
                "nominal": 1,
                "per_unit": 51.4412,
                "valid_for_days": 7
            },
            {
                "code": "BRL",
                "value": 17.2673,
                "nominal": 1,
                "per_unit": 17.2673,
                "valid_for_days": 7
            },
            {
                "code": "BYN",
                "value": 30.9295,
                "nominal": 1,
                "per_unit": 30.9295,
                "valid_for_days": 7
            },
            {
                "code": "BYR",
…(truncated, see openapi.json for full schema)
```

### Convert

#### `GET /v1/convert` — Convert an amount between two currencies via the som

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

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

**Response:**
```json
{
    "data": {
        "to": "EUR",
        "base": "KGS",
        "date": "11.06.2026",
        "from": "USD",
        "rate": 0.86550104,
        "amount": 100,
        "result": 86.550104,
        "source": "NBKR",
        "amount_in_kgs": 8744.91
    },
    "meta": {
        "timestamp": "2026-06-11T07:48:53.043Z",
        "request_id": "ebf718e4-03a7-4c45-b475-369e0405c401"
    },
    "status": "ok",
    "message": "Conversion computed successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "note": "Base currency is the Kyrgyzstani som (KGS). per_unit is the value in KGS of one unit of the foreign currency (value divided by the NBKR Nominal). Dates are the NBKR fixing date (DD.MM.YYYY).",
        "source": "NBKR published XML (nbkr.kg/XML, live)",
        "service": "nbkr-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's daily rate (code=USD).",
            "GET /v1/rates": "All daily KGS reference rates with per-unit values (no params).",
            "GET /v1/weekly": "Weekly accounting rates, valid seven days (no params).",
            "GET /v1/convert": "Convert an amount between two currencies via the som (from=USD&to=EUR&amount=100)."
        },
        "description": "Live official foreign-exchange reference rates from the National Bank of the Kyrgyz Republic (NBKR). The rates endpoint returns every currency the NBKR fixes against the Kyrgyzstani som (KGS) for the day, normalized to a per-unit rate; the rate endpoint returns one currency; the weekly endpoint returns the NBKR's weekly accounting rates (valid seven days); the convert endpoint converts an amount between any two listed currencies by crossing through the som. Live, no key, nothing stored. A distinct national central-bank feed, separate from the other FX and central-bank APIs.",
        "latest_date": "11.06.2026",
        "currency_count": 5,
        "upstream_status": "ok"
    },
    "meta": {
        
…(truncated, see openapi.json for full schema)
```


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