Net International Investment Position

Get the Net International Investment Position (NIIP) for a variety of countries over time from the International Monetary Fund (IMF). The Net International Investment Position is the value of the external financial assets of a country’s residents (direct investment, portfolio investment, financial derivatives, other investment and reserve assets) less the value of their external liabilities, at the end of each period.

Where the current account is the flow, the international investment position is the stock it builds up: a country that runs current account deficits for years finances them by borrowing from or selling assets to the rest of the world, and ends up with a negative position, a net debtor. The position also moves without any transaction, with exchange rates and the prices of the assets and liabilities held.

The position follows the IMF’s Balance of Payments and International Investment Position Manual, sixth edition (BPM6), and is published by the IMF in millions of US dollars, converted at the exchange rate at the end of the period, for about 130 economies quarterly and 175 yearly, and the euro area. A negative value marks a net debtor, a positive value a net creditor.

For more information, see the following sources:

The formula is as follows:

\[\text{Net International Investment Position} = \text{External Financial Assets} - \text{External Liabilities},\;\; \text{at the end of the quarter (period="quarterly") or the year (period="yearly")}\]

Also known as: NIIP, net foreign assets, net external position, net external assets.

Net International Investment Position in Python or via the MCP

Install the Finance Toolkit with:

pip install financetoolkit -U

Then call get_net_international_investment_position as shown below.

from financetoolkit import Economics

economics = Economics(start_date='2015-01-01', end_date="2025-12-31")

economics.get_net_international_investment_position(
    countries=['United States', 'Netherlands', 'Spain', 'Japan'], period='yearly')

Or, after setting up the Finance Toolkit MCP, ask:

How did the net international investment position of the United States, the Netherlands, Spain and Japan, in millions of national currency, develop from 2015 to 2025?

Which returns:

Item United States Netherlands Spain Japan
2015 -7590470 208976 -1038360 2715260
2016 -8258387 299722 -997827 2879336
2017 -7830723 356302 -1183935 2916758
2018 -9795821 455332 -1082426 3080841
2019 -11666440 634921 -1013505 3271768
2020 -11894319 884178 -1159871 3473817
2021 -15357982 730264 -971356 3659120
2022 -14226691 590199 -825201 3166226
2023 -17123596 625354 -818813 3327381
2024 -22127875 753541 -663085 3435052
2025 -21873581 656342 -847469 3594052

Parameters

get_net_international_investment_position accepts the following parameters.

ParameterTypeDescriptionExample
countrieslist[str] | str | NoneA list of countries or a single country to include in the results. Defaults to None.["United States", "Germany"]
periodstr | None“quarterly” (the position at the end of each quarter) or “yearly” (at the end of each year). Defaults to None, which is quarterly, the highest frequency published."weekly"
rollingintThe rolling window size to use for smoothing the data (simple moving average). Defaults to None.4
trailingintThe trailing window size to use for summing the data over trailing periods (e.g. a trailing-4-quarter sum). Defaults to None.4
growthboolWhether to return the growth data or the actual data. Defaults to False.True
lagintThe number of periods to lag the growth data. Defaults to 1.4
standardizeboolWhether to standardize (Z-Score) the result. When combined with growth=True, standardizes the growth values instead of the raw values. Defaults to False.True
roundingint | NoneThe number of decimals to round the results to. Defaults to None, which uses the rounding of the Economics class.2
show_columnsstr | list[str] | NoneThe columns to keep, a name or a list of names, matched on every column level, or the rows when no column has those names (such as the line items of a financial statement). Names that do not exist are logged, and when none exist the result is returned in full. Defaults to None, which keeps every column.None, which keeps every column
Share