Μετάβαση στο περιεχόμενο
GET /v1/country

One economy's full external balance sheet + net-by-function

Δοκιμάστε το ζωντανά

10 δωρεάν κλήσεις την ημέρα — χωρίς εγγραφή, χωρίς κλειδί API. Μέσω του gateway του oanor.

Προσαρμοσμένες κεφαλίδες (προαιρετικά)
api.oanor.com/netiip-api

Δουλεύει. Πάρε ένα κλειδί API και χρησιμοποίησέ το στο έργο σου.

Λάβετε ένα κλειδί API

Αποσπάσματα κώδικα

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

Παράδειγμα απόκρισης

Πραγματική απόκριση αυτού του endpoint, από τον τελευταίο έλεγχο υγείας.

{
    "data": {
        "code": "USA",
        "name": "United States",
        "note": "One economy's external balance sheet: the net international investment position (in US dollars and as a share of GDP), its gross foreign assets and liabilities, and the net position broken down by function — direct investment, portfolio investment, other investment and reserve assets, which sum to the net position. A net creditor owns more abroad than the world owns of it; a net debtor the reverse. End-of-period stock; shares of GDP derived from implied GDP (same data family). Quarterly, cached a few hours.",
        "read": "Net debtor worth -87.6% of GDP — the world owns more of it than it owns abroad, a structural funding dependency. Gross foreign assets 136.7% vs liabilities 224.3% of GDP. By function: direct investment -20.3%, portfolio -60.6%, other -11%, reserves +4.4% (these sum to the net position).",
        "period": "2025-Q4",
        "source": "OECD balance-of-payments statistics (SDMX), DF_IIP",
        "net_usd_bn": -27537.02,
        "net_pct_gdp": -87.6,
        "gross_assets": {
            "usd_bn": 42957.22,
            "pct_gdp": 136.7
        },
        "is_aggregate": false,
        "gross_liabilities": {
            "usd_bn": 70494.24,
            "pct_gdp": 224.3
        },
        "net_by_function_usd_bn": {
            "reserve_assets": 1385.21,
            "other_investment": -3471.34,
            "direct_investment": -6393.85,
            "portfolio_investment": -19048.41
        },
        "net_by_function_pct_gdp": {
            "reserve_assets": 4.4,
            "other_investment": -11,
            "direct_investment": -20.3,
            "portfolio_investment": -60.6
        }
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:20.941Z",
        "request_id": "df45584e-0fe9-4569-ac9b-ed5fd72f4365"
    },
    "status": "ok",
    "message": "Country investment position retrieved successfully",
    "success": true
}