{"uid":"cap_3m6y3Y2q48W7PkE3SbBqa","slug":"basebuilder2-stocks-forex-economic-calendar-38cee145","name":"Basebuilder2 Stocks – Forex Economic Calendar","description":"BaseBuilder Stocks API hub - 21 paid endpoints","url":"https://bbx-stocks.vercel.app/api/forex/calendar","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.130612","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.130612/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.130612","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.130612","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DfkoVUUqzZ5GXjHxptB3a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.130612","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming and historical forex economic calendar events (e.g. central bank decisions, GDP releases, NFP) for a given date range or currency pair.","exampleAgentPrompt":"Pull the forex economic calendar for next week and show me all high-impact events affecting USD and EUR, including the forecast and previous values.","exampleUseCases":[{"title":"Pre-trade macro risk check","prompt":"Before I place any forex trades this week, can you pull the economic calendar and flag all high-impact events for USD, EUR, and GBP so I know which days to avoid?"},{"title":"Algorithmic strategy event filtering","prompt":"Get me the full forex economic calendar for the next 30 days filtered to high-impact events only — I need the event name, currency, date, forecast, and previous reading for my trading bot."},{"title":"Post-release fundamental review","prompt":"Pull last week's forex calendar events for JPY and show me which ones had the biggest surprise — where the actual reading differed most from the forecast."}],"resultDescription":"A list of economic calendar events each containing the event name, affected currency/country, scheduled date and time, impact level (low/medium/high), forecast value, previous value, and actual value (if the event has already occurred).","failureModes":["Invalid or unsupported date range returns empty results or error","Unknown currency pair or country code returns 400 or empty list","Payment authorization failure (402) if USDC payment header is missing or insufficient","Downstream data provider outage causing 503 or stale data","Rate limiting if called too frequently without proper x402 payment"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable forex economic calendar data with impact ratings and consensus forecasts — particularly useful for automated trading systems, pre-trade risk checks, or macro analysis dashboards. Prefer over scraping financial news sites when you need clean structured event data with forecast/actual comparisons.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:25.849Z","isFirstParty":false}