{"uid":"cap_B0BLMTW-vwUozy6o0qxAc","slug":"bea-us-trade-data-via-etf-macro-intelligence-cee85704","name":"BEA US Trade Data via ETF & Macro Intelligence","description":"Crypto ETF flows, institutional fund data, and US macroeconomic events.","url":"https://x402-etf-macro-intelligence.vercel.app/api/bea/trade?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"},"indicator":{"type":"string","description":"Example value: BalGds"}},"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/trade"}},"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_grvFmhKPk52zWzU-sxzwb","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":"Fetches US Bureau of Economic Analysis (BEA) trade balance and goods/services trade data by year and indicator.","exampleAgentPrompt":"Pull the BEA trade balance for goods (BalGds) for the year 2024 so I can see where the US trade deficit stands.","exampleUseCases":[{"title":"Macro briefing for crypto fund analysis","prompt":"I need the BEA goods trade balance figure for 2023 — I'm correlating macro trade deficits with Bitcoin ETF inflow patterns."},{"title":"Historical US trade trend research","prompt":"Can you get me the BEA BalGds trade indicator data for 2022 so I can track how the US trade balance has shifted over the past few years?"},{"title":"Live macro dashboard for institutional desk","prompt":"Fetch the latest BEA trade balance data for 2025 using the BalGds indicator — I want to update my macro dashboard with current figures."}],"resultDescription":"Returns a JSON object with a success flag, the endpoint path, and a data array containing BEA trade statistics for the requested year and indicator (e.g. balance of goods figures).","failureModes":["Invalid or unsupported year returns empty data array","Unrecognized indicator value returns empty or null data","Missing required query parameters may return an error or empty response","BEA upstream data unavailability can cause empty data arrays","Network or server errors on the Vercel deployment return HTTP 5xx"],"whenToPreferThis":"Use this endpoint when you need structured, programmatic access to US BEA trade balance data filtered by year and specific trade indicator, especially in macro-aware crypto or institutional finance workflows where BEA data is needed alongside ETF flow analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T18:44:39.556Z","isFirstParty":false,"canonicalSlug":"bea-us-trade-data-via-etf-macro-intelligence-cee85704"}