{"uid":"cap_mUqaJI9w9o6Dmk8gkrcYk","slug":"heurist-mesh-fred-macro-vintage-history-7e907638","name":"Heurist Mesh: FRED Macro Vintage History","description":"Return point-in-time-safe history for one curated series using ALFRED realtime dates. Use this for backtests or retrospective questions where revised history would be misleading.","url":"https://mesh.heurist.xyz/x402/solana/agents/FredMacroAgent/macro_vintage_history","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["series_key","realtime_date"],"properties":{"view":{"type":"string","default":"level","description":"Transformation applied to the raw series. Each series_key supports a subset of these views; unsupported combinations fail directly. Common pairings: yoy for inflation, qoq_annualized for GDP, change for rates, wow_change for weekly claims."},"debug":{"type":"boolean","default":false,"description":"Debug mode flag. ALWAYS use false."},"limit":{"type":"integer","default":24,"maximum":120,"minimum":1,"description":"Maximum number of observations to return after transformation."},"period":{"type":"string","default":"5y","description":"Rolling lookback window used when `start_date` is omitted."},"end_date":{"type":"string","description":"Inclusive end date in YYYY-MM-DD format. Defaults to `realtime_date`."},"series_key":{"type":"string","description":"Registry-backed macro series key."},"start_date":{"type":"string","description":"Inclusive start date in YYYY-MM-DD format. If omitted, `period` is used."},"realtime_date":{"type":"string","description":"ALFRED realtime date in YYYY-MM-DD format. Returns data as it was known on this date, before subsequent revisions."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"type":"object","additionalProperties":true}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iC2jh-KH-BzpX07Eh--4x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns point-in-time-safe historical data for a curated FRED macroeconomic series using ALFRED real-time dates, preserving original vintage values for backtests and retrospective analysis.","exampleAgentPrompt":"Pull the point-in-time-safe vintage history for the FRED series UNRATE (US unemployment rate) using ALFRED real-time dates — I need the values as they were originally released, not the revised figures, for a backtest covering 2015 through 2020.","exampleUseCases":[{"title":"Backtest with unrevised GDP data","prompt":"I'm running a backtest on a macro trading strategy and need historical US real GDP growth (FRED series A191RL1Q225SBEA) as it was originally reported each quarter from 2010 to 2022 — give me the vintage values before any revisions."},{"title":"Retrospective inflation analysis","prompt":"For a retrospective analysis of Fed policy decisions, pull the original CPI-U (FRED series CPIAUCSL) readings as they were known in real time from January 2018 through December 2021, using ALFRED vintage dates so I'm not seeing revised figures."},{"title":"Point-in-time unemployment for model validation","prompt":"I need to validate my recession model using data that was actually available at the time — can you fetch the FRED unemployment series UNRATE with ALFRED real-time dates for the period from 2007 to 2010, preserving the original vintage values as released?"}],"resultDescription":"Returns a time series of macroeconomic observations for the requested FRED series where each data point reflects the value as it was originally published at the specified vintage/real-time date, not subsequent revisions. Includes observation dates, real-time dates, and the corresponding reported values for the curated series.","failureModes":["Invalid or unsupported FRED series ID returns an error","Requested vintage date outside available ALFRED history returns empty or error","Malformed date range parameters cause validation failure","Network or upstream ALFRED API unavailability causes timeout","Insufficient USDC balance for x402 payment fails the request before execution"],"whenToPreferThis":"Choose this endpoint when you need historically accurate, unrevised macroeconomic data for backtesting or retrospective studies — situations where using revised/current FRED data would introduce look-ahead bias. Prefer this over standard FRED data fetches whenever the original as-released values matter, such as in strategy backtests, Fed policy retrospectives, or any analysis that must reflect what was actually known at a given point in time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:38.447Z","isFirstParty":false}