Service metadata

Code snippets

curl "https://api.oanor.com/nbkr-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/nbkr-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/nbkr-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/nbkr-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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": {
        "timestamp": "2026-06-11T07:48:53.226Z",
        "request_id": "9236eec2-b8d3-48bb-bf80-572587e04c20"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}