{"uid":"cap_DUSZB1n1FOO1edV4v__oR","slug":"forex-factory-economic-calendar-api-a7887718","name":"Forex Factory Economic Calendar API","description":"x402node — precise, deterministic developer and data tools for AI agents. Chain data, parsing, crypto, conversion. Pay-per-call over x402, settled in USDC on Base.","url":"https://api.x402node.dev/finance/econ-calendar","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"],"type":"string"},"queryParams":{"type":"object","properties":{"hours":{"type":"string","description":"Only events within the next N hours (optional)."},"limit":{"type":"string","description":"Max events to return, 1-100 (default 30)."},"impact":{"type":"string","description":"Minimum impact: high (default), medium, low, or all."},"currency":{"type":"string","description":"Filter by currency code(s), comma = OR, e.g. USD,EUR (default all)."},"upcoming":{"type":"string","description":"true (default) for future events only; false to include past events this/next week."}}}},"additionalProperties":false}}},"responseSchema":null,"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_zFCJgaPcdGcW6RW-cYVpT","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":"Returns upcoming high-impact macroeconomic events (FOMC, CPI, NFP, GDP, rate decisions) from the live Forex Factory calendar with forecast, previous, and actual values plus minutes until release","exampleAgentPrompt":"Pull the upcoming high-impact USD economic events from the live Forex Factory calendar — I want to see what's coming up in the next few hours, including the CPI and FOMC, with their forecast and previous values and how many minutes until each one drops.","exampleUseCases":null,"resultDescription":"Returns a JSON object with an array of upcoming economic events each containing title, currency, impact level, scheduled date, minutes until release, forecast value, previous value, and actual value (if already released); also includes a count, applied filter echo, data source label, and a convenience 'next_high_impact' field showing the soonest upcoming high-impact event with its title, currency, date, and minutes until release.","failureModes":["Payment failure if USDC balance is insufficient (402 Payment Required)","No events returned if filters are too narrow (empty events array with count 0)","Stale data if Forex Factory upstream is delayed or unreachable","Invalid filter parameter values may return unfiltered or error response"],"whenToPreferThis":"Choose this endpoint when an agent needs real-time, structured macroeconomic event data not available in LLM training — especially before making trading decisions, when checking for market-moving releases like FOMC, CPI, NFP, or GDP, or when filtering by specific currency or impact level. Prefer over static or LLM-recalled calendar data since this pulls live from Forex Factory.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:21:48.681Z","isFirstParty":false}