{"uid":"cap_MxKP94-kmVWZbG8Tt2cKK","slug":"fathom-macroeconomic-calendar-api-09d4c783","name":"Fathom Macroeconomic Calendar API","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fathom-opal.vercel.app/api/calendar","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"string","description":"Max results (default: 15)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"events":{"type":"array","items":{"type":"object"}},"source":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jwQ0IRDQzQ4n_AcDwXPot","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves upcoming macroeconomic calendar events (economic releases, announcements) powered by FRED data","exampleAgentPrompt":"Can you pull up the next 20 upcoming macroeconomic calendar events from Fathom — things like scheduled GDP releases, inflation reports, and interest rate decisions?","exampleUseCases":[{"title":"Weekly economic release preview","prompt":"What major economic data releases are scheduled in the coming days? Show me the next 15 events from the macro calendar so I can plan around them."},{"title":"Pre-market morning briefing","prompt":"Give me a quick rundown of the top upcoming macroeconomic events I should watch — pull the next 10 from the economic calendar."},{"title":"Research report event tracking","prompt":"I'm writing a market outlook and need to list all major upcoming economic announcements. Can you fetch me the next 25 events from the macroeconomic calendar?"}],"resultDescription":"Returns an array of macroeconomic calendar events (such as scheduled GDP releases, CPI announcements, unemployment reports, interest rate decisions) along with a source attribution string identifying the data provider.","failureModes":["Invalid limit parameter type (must be a string representation of an integer)","Empty events array if no upcoming events are scheduled in the data feed","Payment failure if x402 USDC payment of $0.08 is not processed correctly","Service unavailability on Vercel deployment causing 5xx errors","FRED upstream data outage causing stale or missing calendar data"],"whenToPreferThis":"Use this endpoint when you need to discover upcoming scheduled macroeconomic data release events (e.g., GDP, CPI, unemployment, FOMC decisions) rather than fetching historical time-series values. It is ideal for economic calendars, pre-market briefings, or scheduling workflows around data releases. Prefer this over general FRED time-series queries when the goal is 'what is coming next' rather than 'what happened historically'.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:51:08.217Z","isFirstParty":false}