{"uid":"cap_HsGNTZa7s5Oa6UsR9aatO","slug":"swaphunt-macro-event-history-bb4e3ce0","name":"SwapHunt Macro Event History","description":"Historical macro events with actual vs estimate values (e.g. CPI came in above/below forecast). Use to study how markets reacted to surprises and to backtest event-driven strategies.","url":"https://x402.swaphunt.dev/v1/events/macro/history","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"days":{"type":"integer","default":30,"description":"Days back"},"country":{"type":"string","description":"Country filter (e.g. US)"},"end_date":{"type":"string","description":"ISO date YYYY-MM-DD"},"start_date":{"type":"string","description":"ISO date YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_umBymn0aI7TaiA1vNqOaY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical macroeconomic events with actual vs. estimated values so users can analyze market surprise effects and backtest event-driven strategies.","exampleAgentPrompt":"Pull the historical macro events for the US over the last 90 days — I want to see which ones came in above or below forecast so I can study how markets reacted to surprises like CPI and NFP.","exampleUseCases":[{"title":"Backtest event-driven forex strategy","prompt":"I need historical EUR/USD macro events from the past year with actual versus estimated values so I can backtest a strategy that trades on European economic surprises like inflation and employment data."},{"title":"Identify biggest market movers last quarter","prompt":"Show me the macro events from Q3 that had the largest surprise magnitude — where actual results deviated most from forecasts — so I can understand which economic releases moved markets the most."},{"title":"Analyze Fed policy decision impact historically","prompt":"Pull all historical FOMC announcements and economic data releases for the last two years with the surprise direction and magnitude so I can see how markets have reacted to Fed decisions versus market expectations."}],"resultDescription":"A list of historical macroeconomic events with their scheduled dates, country, event name (e.g. CPI, NFP, FOMC), the consensus estimate, the actual reported value, and the surprise direction/magnitude. Useful for identifying market-moving surprises and building backtests.","failureModes":["Invalid date format returns 400 — must use ISO YYYY-MM-DD","Unknown country code returns empty results or 400","days parameter out of supported range may return partial data or error","Payment not processed (x402 flow failure) returns 402","No events in specified range returns empty array"],"whenToPreferThis":"Use this endpoint when you need historical macroeconomic event data with actual vs. estimate comparisons for backtesting event-driven trading strategies or studying market reactions to economic surprises. Prefer this over forward-looking endpoints when you need past release data with surprise values rather than upcoming scheduled events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:31:55.623Z","isFirstParty":false}