{"uid":"cap_13Lc7l4NvDhXvbN3CotKi","slug":"fathom-macroeconomic-calendar-api-410a9252","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://fredthom.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.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_px9sdpN_njarLaGs92KmZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming macroeconomic calendar events (e.g. scheduled economic data releases) powered by FRED data","exampleAgentPrompt":"Show me the next 20 upcoming macroeconomic calendar events from Fathom's FRED-powered API — things like scheduled GDP, inflation, and unemployment data releases.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing an array of upcoming economic calendar events (e.g. scheduled data releases for GDP, inflation, unemployment, interest rates) and a source identifier string confirming the data origin.","failureModes":["Invalid limit value returns error or default behavior","Empty events array if no upcoming calendar events are indexed","Service unavailability on Vercel hosting returns 5xx","Payment failure (x402) prevents access if USDC payment is not processed","Malformed POST body may return 400 or unexpected response"],"whenToPreferThis":"Use this endpoint when you need a list of upcoming scheduled macroeconomic data release events (economic calendar), particularly sourced from FRED. Prefer this over general economic data series endpoints when the goal is forward-looking scheduling or knowing when key indicators will be published, rather than retrieving historical time-series data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:04.187Z","isFirstParty":false}