Service metadata and endpoint catalog

Extraits de code

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_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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
}