{"uid":"cap_pAXGZlqi1BioOEwwlKxMS","slug":"prereason-macro-calendar-api-79faa2d4","name":"PreReason Macro Calendar API","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/macro/calendar?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"eu-cpi":{"name":"eu-cpi"},"fed-funds-rate":{"name":"fed-funds-rate"},"boj-policy-rate":{"name":"boj-policy-rate"},"next-treasury-auction-days":{"name":"next-treasury-auction-days"}},"briefing_used":"macro.calendar","briefing_metadata":{"name":"Macro Calendar: Releases, Decisions and Auctions","description":"The scheduled dates ahead and the latest US releases as they came out: the next Producer Price Index, retail sales, GDP and Personal Income and Outlays releases, the FOMC minutes, the Federal Reserve's and the ECB's next decisions and the Treasury coupon auctions of the week ahead on Treasury's tentative schedule, or the next one when the week has none, each dated from its publisher's own calendar (dates only, no figures from them); and the US Employment Situation, Consumer Price Index and weekly initial claims as release state: for each, the latest release and when it came out, its headline figures within that one release with each figure's estimate (first, second, advance, revised), what the release revised, and the next scheduled release, all from the publishers' own figures with every version kept. Beside it the federal funds rate, the days to the next Treasury auction, euro area HICP and the BoJ policy rate.","metrics_count":4,"correlations_count":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__FjGDHUS7QEJwziIeeXqU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a structured briefing of upcoming and recent macroeconomic calendar events including Fed decisions, CPI, GDP, Treasury auctions, and key central bank rates","exampleAgentPrompt":"Pull me today's macro calendar briefing in markdown — I want to see the upcoming Fed and ECB decisions, next Treasury auction dates, latest CPI and employment figures, and the current federal funds rate.","exampleUseCases":[{"title":"Weekly macro briefing for portfolio review","prompt":"Give me this week's macro calendar in markdown — I need the upcoming FOMC and ECB decisions, any Treasury coupon auctions, and the latest CPI and jobs numbers so I can prep for our Monday investment committee meeting."},{"title":"Historical macro snapshot for a past date","prompt":"Pull the macro calendar briefing for 2024-09-18 in JSON format — I want to see what the Fed funds rate was, what economic releases had just come out, and what auctions were scheduled around that date."},{"title":"Automated daily macro context for an AI trading agent","prompt":"Every morning, fetch me the latest macro calendar briefing in markdown so my trading agent has the current federal funds rate, next Treasury auction timing, and any scheduled CPI or GDP releases baked into its daily context."}],"resultDescription":"Returns a macro calendar briefing containing: scheduled dates for upcoming economic releases (PPI, retail sales, GDP, PCE, FOMC minutes), Federal Reserve and ECB next decision dates, Treasury coupon auction schedule for the week ahead, and the latest released data for US Employment Situation, CPI, and weekly initial claims (including headline figures, estimates, revisions, and next scheduled release). Also includes current federal funds rate, days to next Treasury auction, euro area HICP, and BoJ policy rate. Available in token-optimized markdown or structured JSON.","failureModes":["Payment required (402) if x402 payment header is missing or insufficient","Invalid date format returns validation error (date must match YYYY-MM-DD)","Date not on record returns empty or error response","Invalid format parameter returns validation error","Network timeout if upstream data sources are unavailable"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a pre-reasoned, consolidated macro calendar context in a single call — covering Fed/ECB/BoJ policy rates, Treasury auction schedules, and recent US economic release data (CPI, jobs, GDP) without having to stitch together multiple data sources. Ideal for daily briefings, portfolio context injection, or any workflow where macro awareness is needed quickly with minimal token overhead. Prefer the markdown format for LLM context windows and JSON for structured downstream processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:23.149Z","isFirstParty":false,"canonicalSlug":"prereason-macro-calendar-api-79faa2d4"}