/v1/country
One economy's full external balance sheet + net-by-function
Pruébalo en vivo
10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.
Funciona. Consigue una clave API y úsala en tu proyecto.
Obtener una clave APIFragmentos de código
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_..."}
)
Respuesta de ejemplo
Una respuesta real de este endpoint, capturada en la última comprobación de estado.
{
"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
}