Service metadata and endpoint catalog

Extraits de code

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

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

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

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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
}