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:
- International Monetary Fund (2009). Balance of Payments and International Investment Position Manual, Sixth Edition (BPM6), chapter 7: https://www.imf.org/external/pubs/ft/bop/2007/pdf/bpm6.pdf
- IMF International Investment Position dataset: https://data.imf.org
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.
| Parameter | Type | Description | Example |
|---|---|---|---|
countries | list[str] | str | None | A list of countries or a single country to include in the results. Defaults to None. | ["United States", "Germany"] |
period | str | 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" |
rolling | int | The rolling window size to use for smoothing the data (simple moving average). Defaults to None. | 4 |
trailing | int | The trailing window size to use for summing the data over trailing periods (e.g. a trailing-4-quarter sum). Defaults to None. | 4 |
growth | bool | Whether to return the growth data or the actual data. Defaults to False. | True |
lag | int | The number of periods to lag the growth data. Defaults to 1. | 4 |
standardize | bool | Whether to standardize (Z-Score) the result. When combined with growth=True, standardizes the growth values instead of the raw values. Defaults to False. | True |
rounding | int | None | The number of decimals to round the results to. Defaults to None, which uses the rounding of the Economics class. | 2 |
show_columns | str | list[str] | None | The 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 |