bea_international_investment
Access U.S. international investment position data to analyze financial assets and liabilities, track changes from transactions, price movements, and exchange rates.
Instructions
Get U.S. international investment position (IIP) data.
Shows end-of-period accumulated stocks of U.S. financial assets and liabilities.
TypeOfInvestment examples:
FinAssetsExclFinDeriv: U.S. assets excl derivatives (default)
FinLiabsExclFinDeriv: U.S. liabilities excl derivatives
DirInvAssets: Direct investment assets
FinLiabsFoa: Liabilities to foreign official agencies
Component: 'Pos' (position), 'ChgPosTrans' (change from transactions), 'ChgPosPrice' (from price changes), 'ChgPosXRate' (from exchange rates)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type_of_investment | No | 'FinAssetsExclFinDeriv' (default). Use bea_dataset_info for full list. | |
| component | No | 'Pos' (position, default), 'ChgPosTrans', 'ChgPosPrice', 'ChgPosXRate', or 'All' | |
| frequency | No | 'A' (annual, default), 'QNSA' (quarterly not seasonally adjusted) | |
| year | No | Year(s): 'ALL' (default), or comma-separated years |