Spec

Frammenti di codice

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

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

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

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "note": "country is an ISO-2 code (US, DE, GB, JP) or a common name. history sector is government (default), households, corporates or private_total. history quarters is 2-240 (default 40). Total credit at market value, all lenders, % of GDP. Quarterly with the usual lag; briefly cached.",
        "source": "BIS Data Portal (stats.bis.org/api/v2, WS_TC, quarterly, live)",
        "sectors": [
            "government",
            "households",
            "corporates",
            "private_total"
        ],
        "service": "debttogdp-api",
        "countries": 32,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/latest": "Every country's government/household/corporate/total-private debt-to-GDP, sortable (sort=government|households|corporates|private_total|country).",
            "GET /v1/country": "One country's four sector debt-to-GDP ratios (country=US).",
            "GET /v1/history": "One country's quarterly debt-to-GDP for a sector (country=US, sector=government, quarters=40)."
        },
        "description": "Debt-to-GDP by sector — how indebted each economy's government, households and companies are, from the BIS open statistics (no key, nothing stored). latest returns every country's government, household, corporate and total-private debt-to-GDP; country returns one country's four sector ratios; history returns a sector's quarterly series. The debt-level / leverage macro cut — distinct from the credit-to-GDP gap (stretch vs trend), the debt service ratio (cost of carrying debt), credit-growth (lending volumes), bank-rate and FX APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:38.187Z",
        "request_id": "369f61bf-d0f9-4470-b08b-3f295cc9b142"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}