Service metadata and endpoint catalog

Frammenti di codice

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

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

$ch = curl_init("https://api.oanor.com/bnm-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/bnm-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 Moldova daily rate file (bnm.md, live)",
        "service": "bnm-api",
        "usd_mdl": 17.3528,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, leu-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The BNM official rate for every currency vs the leu.",
            "GET /v1/convert": "Convert an amount between two currencies at BNM 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 Moldova (BNM), the central bank of the Republic of Moldova, for the Moldovan leu (MDL), via its public daily rate file. The rates endpoint returns the BNM's official rate for every published currency against the leu, normalised to one unit; the rate endpoint returns a single currency's official rate (leu-per-unit and the inverse); 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 MDL) at the BNM's official rates, cross-computed through the leu. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK and other central-bank feeds and from market mid-rates — this is the National Bank of Moldova's own official leu exchange rate.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:00.996Z",
        "request_id": "d27635a8-1f89-4c7b-950c-d28c9828a030"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}