Service metadata and endpoint catalog

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/bnr-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/bnr-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 Romania reference rate file (bnr.ro, live)",
        "service": "bnr-api",
        "usd_ron": 4.5286,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's reference rate, leu-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The BNR reference rate for every currency vs the leu.",
            "GET /v1/convert": "Convert an amount between two currencies at BNR rates (from=USD, to=EUR, amount=100).",
            "GET /v1/history": "A currency's reference rate on a specific past date (currency=USD, date=2026-05-15)."
        },
        "description": "Live official reference exchange-rate data from the National Bank of Romania (BNR), the central bank of Romania, for the leu (RON), via its public daily rate file. The rates endpoint returns the BNR's official reference rate for every published currency against the leu, normalised to one unit; the rate endpoint returns a single currency's reference rate (leu-per-unit and the inverse); the history endpoint returns a currency's reference rate on a specific past date from the BNR's yearly archive; the convert endpoint converts an amount between any two published currencies (including RON) at the BNR's reference rates, cross-computed through the leu. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK, BNM, NBT and other central-bank feeds and from market mid-rates — this is the National Bank of Romania's own official leu reference rate.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:47.715Z",
        "request_id": "268d47b6-c4ee-4333-8e68-c106464f99e1"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}