{"uid":"cap_rWrJSLmj3n_S85P16tV7u","slug":"bea-international-investment-position-data-5b7b8072","name":"BEA International Investment Position Data","description":"Crypto ETF flows, institutional fund data, and US macroeconomic events.","url":"https://x402-etf-macro-intelligence.vercel.app/api/bea/international-investment?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","properties":{"year":{"type":"string","description":"Example value: 2026"}},"additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"data":[],"success":true,"endpoint":"/api/bea/international-investment"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ruHseI08jlBj3BMDFtk70","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves US Bureau of Economic Analysis (BEA) international investment position data, including cross-border capital flows and balance of payments statistics, filtered by year.","exampleAgentPrompt":"Pull the BEA international investment position data for 2023 so I can see the US cross-border capital flows and net foreign asset position.","exampleUseCases":[{"title":"Macro research on US foreign liabilities","prompt":"Can you get me the BEA international investment position data for 2022? I want to understand how much foreign capital was invested in the US and what the net international investment position looked like that year."},{"title":"Crypto ETF macro context analysis","prompt":"Fetch the BEA international investment statistics for 2024 — I need the cross-border flows data to provide macro context for my analysis of institutional crypto ETF inflows."},{"title":"Year-over-year capital flow comparison","prompt":"Get me the US international investment position data from BEA for both 2021 and 2022 so I can compare how cross-border capital flows shifted between those years."}],"resultDescription":"Returns a JSON object with a success flag, the endpoint path, and a data array containing BEA international investment position records for the requested year, including metrics on US assets abroad, foreign assets in the US, and net international investment positions.","failureModes":["Invalid or future year parameter returns empty data array with success:true","BEA upstream data unavailability may return empty results","Missing required year parameter may default to a recent year or return an error","Rate limiting or payment failure returns 402 status requiring USDC micropayment"],"whenToPreferThis":"Choose this endpoint when you need structured, programmatic access to US Bureau of Economic Analysis international investment position data with per-call micropayment pricing, especially in macro research workflows analyzing cross-border capital flows alongside crypto ETF institutional data. Prefer over direct BEA API access when you want a unified macro intelligence platform with consistent JSON formatting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T18:31:24.436Z","isFirstParty":false,"canonicalSlug":"bea-international-investment-position-data-5b7b8072"}