{"uid":"cap__fsK-J0liLRgznCNu2VPG","slug":"x402stock-economic-calendar-fda4252c","name":"x402stock Economic Calendar","description":"Upcoming US economic data releases — WHEN the market-moving prints land, not just their latest values. Returns curated high-importance releases (CPI, PPI, PCE, jobs, JOLTS, GDP, retail sales, housing starts, industrial production) within `?days=` (default 30, max 90), each with date and category, plus the next FOMC meeting. `?past=true` includes the last week. Release dates from FRED.","url":"https://x402stock.vercel.app/api/v1/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["days","past"],"properties":{"days":{"type":"integer","default":30,"maximum":90,"exclusiveMinimum":0},"past":{"enum":["true","false"],"type":"string","default":"false"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","window_days","from","to","count","releases","fomc","attribution"],"properties":{"to":{"type":"string"},"fomc":{"type":"object","required":["next_meeting","days_until"],"properties":{"days_until":{"anyOf":[{"type":"number"},{"type":"null"}]},"next_meeting":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"from":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"source":{"type":"string","const":"fred"},"releases":{"type":"array","items":{"type":"object","required":["release_id","name","category","date"],"properties":{"date":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"release_id":{"type":"number"}},"additionalProperties":false}},"attribution":{"type":"string"},"window_days":{"type":"number"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UQ-cSju6B-z1eMQW2uqZ-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming (and optionally past) high-importance US economic data release dates — CPI, PPI, PCE, jobs, GDP, and more — plus the next FOMC meeting date, sourced from FRED","exampleAgentPrompt":"What major US economic releases — like CPI, jobs, or GDP — are coming out in the next 45 days, and when is the next FOMC meeting?","exampleUseCases":[{"title":"Pre-trade macro risk check","prompt":"Can you pull up all the high-impact US economic events scheduled in the next 30 days? I want to know what data prints might move markets before I enter a position."},{"title":"Fed meeting countdown for investor update","prompt":"When is the next FOMC meeting, and what key economic reports like PCE or jobs data are due out before it over the next 60 days?"},{"title":"Weekly macro briefing with recent history","prompt":"Give me the upcoming US economic release calendar for the next 30 days, and also include what came out over the past week so I have full context for my morning briefing."}],"resultDescription":"A JSON object containing: the data source (FRED), as-of timestamp, window parameters (from/to dates, window_days, count), an array of upcoming high-importance releases each with release_id, name, category, and date, a fomc object with next_meeting date and days_until, and an attribution string.","failureModes":["days parameter exceeds 90 — validation error","days parameter is 0 or negative — validation error","No releases found in window — returns empty releases array with count 0","FRED upstream unavailable — potential 5xx or stale data","past parameter must be string 'true' or 'false', not boolean — may cause parse error"],"whenToPreferThis":"Use this endpoint when you need the precise dates of upcoming US macro data releases (CPI, PPI, PCE, NFP, GDP, JOLTS, retail sales, housing starts, industrial production) and the next FOMC meeting, rather than the actual latest values of those indicators. Ideal for pre-trade risk planning, macro calendars, or scheduling automated checks around market-moving events. Prefer this over general economic data endpoints when timing — not magnitude — is the primary need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:35:46.086Z","isFirstParty":false}