{"uid":"cap_RTEdRCnmZotlsy7LtsPWU","slug":"bea-personal-income-data-f9c911ff","name":"BEA Personal Income Data","description":"Crypto ETF flows, institutional fund data, and US macroeconomic events.","url":"https://x402-etf-macro-intelligence.vercel.app/api/bea/personal-income?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/personal-income"}},"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_dU802BfS0vJgPT4OYogJV","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) personal income data for a specified year from the ETF & Macro Intelligence platform.","exampleAgentPrompt":"Pull the BEA personal income data for 2024 from the ETF & Macro Intelligence service so I can see how US household income trends relate to crypto ETF inflows.","exampleUseCases":[{"title":"Macro context for crypto ETF analysis","prompt":"Get me the BEA personal income figures for 2023 — I want to see if rising US household income correlates with the surge in crypto ETF inflows that year."},{"title":"Year-over-year income trend research","prompt":"Fetch the BEA personal income data for both 2022 and 2023 so I can compare how US personal income changed year over year."},{"title":"Macro dashboard data refresh","prompt":"Pull the latest BEA personal income statistics for 2025 so I can update my macro dashboard with current US income figures."}],"resultDescription":"Returns a JSON object with a success flag, the endpoint path, and a data array containing BEA personal income statistics for the requested year. The data array may include time-series income figures, component breakdowns, or aggregate totals as sourced from the BEA.","failureModes":["Invalid or unsupported year parameter returns empty data array with success:true","Year with no available BEA data returns empty data array","Payment not completed (402) blocks access to the endpoint","Network or upstream BEA data unavailability causes request failure","Missing required year parameter may return incomplete or default results"],"whenToPreferThis":"Choose this endpoint when you need structured US personal income data sourced from the BEA for macro-level financial analysis, particularly in contexts involving crypto ETF flow research, institutional fund analysis, or correlating macroeconomic trends with market movements. It is ideal for agents that need clean, pre-fetched BEA data without building direct BEA API integrations, and when per-query micropayment cost ($0.01 USDC) is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T18:42:28.269Z","isFirstParty":false,"canonicalSlug":"bea-personal-income-data-f9c911ff"}