Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/history

A currency's daily MNB rate over a date range

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/mnb-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/mnb-api/v1/history" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/mnb-api/v1/history", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/mnb-api/v1/history");
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/history",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "to": "2026-05-31",
        "base": "HUF",
        "from": "2026-05-01",
        "count": 19,
        "source": "Magyar Nemzeti Bank",
        "history": [
            {
                "date": "2026-05-04",
                "unit": 1,
                "huf_per_unit": 309.77
            },
            {
                "date": "2026-05-05",
                "unit": 1,
                "huf_per_unit": 311.28
            },
            {
                "date": "2026-05-06",
                "unit": 1,
                "huf_per_unit": 305.55
            },
            {
                "date": "2026-05-07",
                "unit": 1,
                "huf_per_unit": 303
            },
            {
                "date": "2026-05-08",
                "unit": 1,
                "huf_per_unit": 301.89
            },
            {
                "date": "2026-05-11",
                "unit": 1,
                "huf_per_unit": 301.71
            },
            {
                "date": "2026-05-12",
                "unit": 1,
                "huf_per_unit": 303.7
            },
            {
                "date": "2026-05-13",
                "unit": 1,
                "huf_per_unit": 306.96
            },
            {
                "date": "2026-05-14",
                "unit": 1,
                "huf_per_unit": 305.67
            },
            {
                "date": "2026-05-15",
                "unit": 1,
                "huf_per_unit": 309.23
            },
            {
                "date": "2026-05-18",
                "unit": 1,
                "huf_per_unit": 309.57
            },
            {
                "date": "2026-05-19",
                "unit": 1,
                "huf_per_unit": 310.28
            },
            {
                "date": "2026-05-20",
                "unit": 1,
                "huf_per_unit": 311.77
            },
            {
                "date": "2026-05-21",
                "unit": 1,
                "huf_per_unit": 308.96
            },
            {
                "date": "2026-05-22",
                "unit": 1,
                "huf_per_unit": 309.41
            },
            {
                "date": "2026-05-26",
                "unit": 1,
                "huf_per_unit": 306.63
            },
            {
                "date": "2026-05-27",
                "unit": 1,
                "huf_per_unit": 304.98
            },
            {
                "date": "2026-05-28",
                "unit": 1,
                "huf_per_unit": 305.98
            },
            {
                "date": "2026-05-29",
                "unit": 1,
                "huf_per_unit": 304.86
            }
        ],
        "currency": "USD"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:44.299Z",
        "request_id": "94dadd48-9b98-4511-8be6-31f16ac961cd"
    },
    "status": "ok",
    "message": "History retrieved successfully",
    "success": true
}