{"uid":"cap_YxHS1tQ8ioCXcbCHA21q6","slug":"trading-data-api-macro-economic-calendar-a8a18d3e","name":"Trading Data API – Macro Economic Calendar","description":"Trading Data API — 23 endpoints for agents: crypto & stock prices/OHLCV, ATR, Fair Value Gaps, ICT liquidity levels, funding/OI, order books, Kalshi prediction markets, DeFi TVL, volatility, macro calendar, and an AI momentum score. Full catalog at /v1/status.","url":"https://api-production-54bd.up.railway.app/v1/macro-calendar","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zkCwz3ThuSUZPn89QOUJa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming and recent macroeconomic events (e.g. Fed meetings, CPI releases, NFP) relevant to trading decisions","exampleAgentPrompt":"Pull the macro economic calendar for the next week and flag any high-impact events like Fed decisions, CPI, or NFP that could move the markets.","exampleUseCases":null,"resultDescription":"A list of upcoming macroeconomic events with timestamps, event names (e.g. FOMC, CPI, NFP), expected and previous values, actual values (if released), impact ratings, and the currency/region they affect — useful for timing trades around volatility-inducing news.","failureModes":["No events available for requested date range — empty array returned","Invalid query parameters — 400 error with message","Upstream data source unavailable — 503 or timeout","Payment not processed (x402) — 402 Payment Required if USDC payment not attached"],"whenToPreferThis":"Use this endpoint when an agent or trader needs to anticipate market-moving economic data releases, plan entries/exits around volatility, or contextualize price action with scheduled macro events. Prefer over generic news APIs when you need structured, time-stamped economic event data with forecast vs actual values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:38:39.216Z","isFirstParty":false}