Naar de inhoud
GET /v1/country

One country's long-term yield + history

Probeer het live

10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.

Aangepaste headers (optioneel)
api.oanor.com/worldbonds-api

Het werkt. Haal een API-key op en gebruik hem in je project.

Verkrijg een API-sleutel

Codefragmenten

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

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "data": {
        "code": "USA",
        "period": "2026-05",
        "source": "OECD",
        "country": "United States",
        "history": [
            {
                "value": 4.31,
                "period": "2024-06"
            },
            {
                "value": 4.25,
                "period": "2024-07"
            },
            {
                "value": 3.87,
                "period": "2024-08"
            },
            {
                "value": 3.72,
                "period": "2024-09"
            },
            {
                "value": 4.1,
                "period": "2024-10"
            },
            {
                "value": 4.36,
                "period": "2024-11"
            },
            {
                "value": 4.39,
                "period": "2024-12"
            },
            {
                "value": 4.63,
                "period": "2025-01"
            },
            {
                "value": 4.45,
                "period": "2025-02"
            },
            {
                "value": 4.28,
                "period": "2025-03"
            },
            {
                "value": 4.28,
                "period": "2025-04"
            },
            {
                "value": 4.42,
                "period": "2025-05"
            },
            {
                "value": 4.38,
                "period": "2025-06"
            },
            {
                "value": 4.39,
                "period": "2025-07"
            },
            {
                "value": 4.26,
                "period": "2025-08"
            },
            {
                "value": 4.12,
                "period": "2025-09"
            },
            {
                "value": 4.06,
                "period": "2025-10"
            },
            {
                "value": 4.09,
                "period": "2025-11"
            },
            {
                "value": 4.14,
                "period": "2025-12"
            },
            {
                "value": 4.21,
                "period": "2026-01"
            },
            {
                "value": 4.13,
                "period": "2026-02"
            },
            {
                "value": 4.25,
                "period": "2026-03"
            },
            {
                "value": 4.32,
                "period": "2026-04"
            },
            {
                "value": 4.48,
                "period": "2026-05"
            }
        ],
        "measure": "long-term (≈10Y) government bond yield",
        "yield_pct": 4.48
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:38.164Z",
        "request_id": "8ed65544-0844-49a6-9817-9e4c9177f208"
    },
    "status": "ok",
    "message": "Country yield retrieved successfully",
    "success": true
}