Service metadata

Code snippets

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

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

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

Example response

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

{
    "data": {
        "date": "2026-06-10",
        "source": "MNB SOAP web service arfolyamok.asmx (mnb.hu, live)",
        "service": "mnb-api",
        "usd_huf": 307.98,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, forint-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The MNB official daily rate for every currency vs the forint.",
            "GET /v1/convert": "Convert an amount between two currencies at MNB rates (from=USD, to=EUR, amount=100).",
            "GET /v1/history": "A currency's daily MNB rate over a date range (currency=USD, from=2026-05-01, to=2026-05-31)."
        },
        "description": "Live official exchange-rate data from the National Bank of Hungary (Magyar Nemzeti Bank, MNB), the central bank of Hungary, for the forint (HUF), via the MNB's public SOAP web service. The rates endpoint returns the MNB's official daily rate for every published currency against the forint, normalised to one unit; the rate endpoint returns a single currency's forint-per-unit rate and the inverse; the history endpoint returns a currency's daily MNB rate over a date range from the MNB's own time-series method; the convert endpoint converts an amount between any two published currencies (including HUF) at the MNB's official rates, cross-computed through the forint. Live, no key, nothing stored. Distinct from the ECB, SNB, BNR, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK, BNM, NBT and other central-bank feeds and from market mid-rates — this is the Magyar Nemzeti Bank's own official forint rate, delivered over SOAP.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:44.590Z",
        "request_id": "9e804f62-cf27-40de-9e68-9b4ae8294dac"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}