{"uid":"cap_twk31y9zThLdM5P7H_9Qr","slug":"x402stock-economic-calendar-fomc-schedule-213b4a11","name":"x402stock Economic Calendar & FOMC Schedule","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.xyz/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":{"type":"json","example":{"to":"2026-07-05","fomc":{"days_until":12,"next_meeting":"2026-06-17"},"from":"2026-06-05","as_of":"2026-06-05T12:00:00.000Z","count":3,"source":"fred","releases":[{"date":"2026-06-10","name":"Consumer Price Index","category":"inflation","release_id":10},{"date":"2026-07-02","name":"Employment Situation","category":"employment","release_id":50},{"date":"2026-06-25","name":"Gross Domestic Product","category":"growth","release_id":53}],"attribution":"Economic release dates: Federal Reserve Bank of St. Louis (FRED). FOMC meeting dates: U.S. Federal Reserve.","window_days":30}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"days":30,"past":"false"}}},"response":{"to":"2026-07-12","fomc":{"days_until":5,"next_meeting":"2026-06-17"},"from":"2026-06-12","as_of":"2026-06-12T04:58:48.744Z","count":12,"source":"fred","releases":[{"date":"2026-06-15","name":"Industrial Production","category":"growth","release_id":13},{"date":"2026-06-16","name":"Housing Starts","category":"housing","release_id":27},{"date":"2026-06-17","name":"Retail Sales","category":"consumer","release_id":9},{"date":"2026-06-18","name":"Initial Jobless Claims","category":"employment","release_id":180},{"date":"2026-06-24","name":"Housing Starts","category":"housing","release_id":27},{"date":"2026-06-25","name":"Gross Domestic Product (GDP)","category":"growth","release_id":53},{"date":"2026-06-25","name":"Initial Jobless Claims","category":"employment","release_id":180},{"date":"2026-06-25","name":"Personal Income & Outlays (PCE)","category":"inflation","release_id":54},{"date":"2026-06-30","name":"Job Openings & Labor Turnover (JOLTS)","category":"employment","release_id":192},{"date":"2026-07-02","name":"Employment Situation","category":"employment","release_id":50},{"date":"2026-07-02","name":"Initial Jobless Claims","category":"employment","release_id":180},{"date":"2026-07-09","name":"Initial Jobless Claims","category":"employment","release_id":180}],"attribution":"Economic release dates: Federal Reserve Bank of St. Louis (FRED). FOMC meeting dates: U.S. Federal Reserve.","window_days":30}},"exampleRequest":{"days":30,"past":"false"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_pytWMecOHN90UYDgiTyCp","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 (or past) US macroeconomic data release dates from FRED and FOMC meeting schedule within a configurable day window","exampleAgentPrompt":"What major US economic data releases and Fed meetings are scheduled over the next 30 days? Show me upcoming events, not past ones.","exampleUseCases":[{"title":"Trading strategy briefing for market movers","prompt":"Give me all the major economic releases coming in the next two weeks so I can adjust my portfolio positions before the data drops."},{"title":"Weekly market risk newsletter content","prompt":"What Fed meetings and macro data are scheduled for the next 7 days? I need to warn our subscribers about potential volatility."},{"title":"Real-time trading desk alerts","prompt":"Tell me when the next employment report and CPI release are—I want to know if any big macro announcements hit within the next 10 days."}],"resultDescription":"Returns a JSON object with: date range (from/to), count of releases, an array of upcoming economic releases each with date, name, category (e.g. inflation, employment, growth), and release_id from FRED, plus a FOMC object showing the next meeting date and how many days away it is, along with FRED/Fed attribution.","failureModes":["Invalid 'days' parameter (must be integer 1-90): returns 400 error","Invalid 'past' value (must be 'true' or 'false' string): returns 400 error","FRED upstream unavailable: may return 503 or stale data","Payment not fulfilled (x402): returns 402 Payment Required before data is served","days exceeds maximum of 90: returns validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to know when upcoming (or recent past) US macroeconomic data releases or FOMC meetings are scheduled — ideal for planning trades, briefing users on market-moving events, or building economic calendars. Prefer this over general web search when you need structured, FRED-sourced release dates with categories and IDs in a single pay-per-call call with no API key required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:47:25.446Z","isFirstParty":false}