Spec

Code snippets

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

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

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

Example response

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

{
    "data": {
        "source": "Narodowy Bank Polski Web API (live)",
        "service": "nbp-api",
        "endpoints": {
            "GET /v1/gold": "NBP gold price (PLN per gram) + history (history=N).",
            "GET /v1/meta": "This document.",
            "GET /v1/rates": "NBP daily fixing — every currency's mid vs PLN (table=A default, or B for exotics).",
            "GET /v1/bidask": "Full trading table C — every currency's bid, ask and spread.",
            "GET /v1/convert": "Convert between any two currencies via PLN (from=USD&to=EUR&amount=100).",
            "GET /v1/currency": "One currency's mid + bid/ask + history (code=USD)."
        },
        "description": "Live official Polish FX and gold data from the National Bank of Poland: the daily fixing (mid rate of every world currency vs the zloty, tables A and B); one currency's mid, bid and ask with recent history; the full trading table (table C) with bid, ask and spread; the NBP gold price (one gram of pure gold in zloty) with history; and currency conversion between any two currencies crossed through the zloty. Live, no key, nothing stored. Distinct from the ECB, Fed, Bank of Canada, Norges Bank, Bank of England and Brazil central-bank APIs — this is the zloty, its bid/ask table and the NBP gold price.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:24.940Z",
        "request_id": "5f29e829-e971-41ce-8f0b-eaa2200dcf2a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}