One economy's full external decomposition + trend

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/currentaccount-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/currentaccount-api/v1/country",
    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": {
        "code": "USA",
        "name": "United States",
        "note": "One economy's external balance: the headline current account as a share of GDP, decomposed into the goods, services, primary-income (cross-border investment income) and secondary-income (transfers) balances — in billions of US dollars per quarter (which sum exactly to the current account) and as shares of GDP. The six-quarter trend shows whether the position is widening or narrowing. Quarterly, seasonally adjusted, cached a few hours.",
        "read": "Deficit of 2.43% of GDP, improving (balance up 1.76 pts year-on-year) — a net borrower from the world. Composition: goods -3.08%, services +1.04%, primary income +0.3%, secondary income -0.7% (of GDP). The balances sum to the current account.",
        "trend": [
            {
                "period": "2024-Q3",
                "balance_pct": -4.42
            },
            {
                "period": "2024-Q4",
                "balance_pct": -4.18
            },
            {
                "period": "2025-Q1",
                "balance_pct": -5.84
            },
            {
                "period": "2025-Q2",
                "balance_pct": -3.25
            },
            {
                "period": "2025-Q3",
                "balance_pct": -3.08
            },
            {
                "period": "2025-Q4",
                "balance_pct": -2.43
            }
        ],
        "period": "2025-Q4",
        "source": "OECD balance-of-payments statistics (SDMX)",
        "balance_pct": -2.43,
        "is_aggregate": false,
        "change_yoy_pts": 1.76,
        "decomposition_usd_bn": {
            "goods": -241.46,
            "services": 81.43,
            "primary_income": 23.92,
            "current_account": -190.74,
            "secondary_income": -54.64
        },
        "decomposition_pct_gdp": {
            "goods": -3.08,
            "services": 1.04,
            "primary_income": 0.3,
            "secondary_income": -0.7
        }
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:24.487Z",
        "request_id": "df5a4c98-4a85-4134-9d89-0d4a2466a0d1"
    },
    "status": "ok",
    "message": "Country external balance retrieved successfully",
    "success": true
}