Service metadata and endpoint catalog

Frammenti di codice

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

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

$ch = curl_init("https://api.oanor.com/nbu-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/nbu-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "source": "National Bank of Ukraine statistics API (bank.gov.ua, live)",
        "service": "nbu-api",
        "usd_uah": 44.979,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, hryvnia-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The NBU official rate for every currency vs the hryvnia.",
            "GET /v1/convert": "Convert an amount between two currencies at NBU rates (from=USD, to=EUR, amount=100).",
            "GET /v1/history": "Daily time series of a currency's official rate (currency=USD, from, to)."
        },
        "description": "Live official exchange-rate data from the National Bank of Ukraine (NBU), the central bank of Ukraine, for the hryvnia (UAH), via its public statistics API. The rates endpoint returns the NBU's official daily rate for every one of 45-plus currencies against the hryvnia; the rate endpoint returns a single currency's official rate (hryvnia-per-unit and the inverse); the history endpoint returns the daily time series of a currency's official rate over a date range; the convert endpoint converts an amount between any two currencies (including UAH) at the NBU's official rates, cross-computed through the hryvnia. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR and Riksbank feeds and from market mid-rates — this is the National Bank of Ukraine's own official hryvnia exchange rate.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:47.185Z",
        "request_id": "8fe3c7c4-ec41-4f69-8b2b-95751c7506ea"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}