Service metadata and endpoint catalog

Frammenti di codice

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

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

$ch = curl_init("https://api.oanor.com/nbt-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/nbt-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 Tajikistan daily rate file (nbt.tj, live)",
        "service": "nbt-api",
        "usd_tjs": 9.3537,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, somoni-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The NBT official rate for every currency vs the somoni.",
            "GET /v1/convert": "Convert an amount between two currencies at NBT 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 Tajikistan (NBT), the central bank of the Republic of Tajikistan, for the somoni (TJS), via its public daily rate file. The rates endpoint returns the NBT's official rate for every published currency against the somoni, normalised to one unit; the rate endpoint returns a single currency's official rate (somoni-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 TJS) at the NBT's official rates, cross-computed through the somoni. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK, BNM and other central-bank feeds and from market mid-rates — this is the National Bank of Tajikistan's own official somoni exchange rate.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:55.573Z",
        "request_id": "43be3d4e-4569-4675-979f-1700efcd50bc"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}