Macro Series (FRED data — ALFRED vintages, honest first-print vs revised values for backtests)
macro_seriesPoint-in-time historical values for a FRED macro series — backed by ALFRED vintages so a query at as_of=2020-05-15 for UNRATE returns the first-print value (14.7) not the later revision (14.8). The honest PIT macro reader.
Why this is the right shape: every other macro source returns 'current best value' which silently puts revised data into a backtest of a strategy that ran on first-print data — lookahead bias. ALFRED vintages let you ask 'what did everyone see on day X' and get the truth.
Inputs:
series_id(required) — FRED id, e.g.UNRATE,CPILFESL,DGS10,VIXCLS,NFCI. See covered list below.start/end— YYYY-MM-DD bounds onobs_date(observation period).startdefault isas_of - 1 year;enddefaults toas_of.as_of— YYYY-MM-DD vintage cutoff (default today). Returns latest vintage ≤ this date perobs_date. 0 rows is a valid answer — means the print hadn't been released byas_of(e.g. UNRATE for 2020-04-01 obs at as_of='2020-05-01' = empty; the April report was released 2020-05-08).limit— max rows returned (default 500, max 5000 — full daily series can be large).
as_of_effective = MAX(realtime_start) among the returned rows — the true currency of the data at as_of. If no rows: as_of_effective echoes as_of with a no_data_before_as_of: true flag (the 'print not yet released' signal).
Coverage (44 series total, daily refresh):
24 ALFRED-true vintages (revision-prone, reconstruct first-print vs revised exactly):
CPILFESL,PAYEMS,UNRATE,INDPRO,CFNAIMA3,UMCSENT,ICSA,GACDFSA066MSFRBPHI(Philly Fed mfg),GACDISA066MSFRBNY(Empire Manufacturing), BAML credit indices (BAMLC0A0CM,BAMLC0A1CAAA,BAMLC0A3CA,BAMLC0A4CBBB,BAMLH0A0HYM2,BAMLH0A1HYBB,BAMLH0A3HYC),DCOILWTICO(WTI),DTWEXBGS(USD broad index),ECBDFR,THREEFYTP10(Adrian-Crump term premium), some intl rates (IRSTCB01JPM156N,IRSTCI01AUM156N,IRSTCI01GBM156N),TEDRATE.20
final_synthseries (daily/weekly market series — non-revised so synthesized first-knowable date as obs_date + 1 business day): Treasury yields (DGS1MO,DGS3MO,DGS6MO,DGS1-DGS30),DFF(Fed Funds),DFII10(10Y TIPS),T10Y2Y/T10Y3M/T10YIE(curve + breakeven),VIXCLS,NFCI(Chicago Fed NFCI),STLFSI4(St. Louis Fed Financial Stress),USEPUINDXD(EPU index).
Important caveat on final_synth: for the 2 recomputed weekly indices (NFCI, STLFSI4), final_synth means intermediate revisions are NOT represented — final values only. For market-priced series (yields, VIX, FX, oil), the synthesized date is correct because those don't get revised.
Smoke goldens (FRED team 2026-06-14, verified live): UNRATE 2020-04-01 first-print 14.7 at as_of='2020-05-15' (realtime_start=2020-05-08); UNRATE 2020-04-01 at as_of='2020-05-01' returns 0 rows (April report released 2020-05-08, so not yet knowable). Pair with macro_calendar for 'when does the next print drop.'
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"series_id": "<series_id>"
},
"name": "macro_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Upper bound on obs_date YYYY-MM-DD (default as_of). | |
| as_of | No | Vintage cutoff date YYYY-MM-DD (default today). The PIT key — selects the vintage of value that was current at this date. | |
| limit | No | Max rows returned (default 500, max 5000). | |
| start | No | Lower bound on obs_date YYYY-MM-DD (default as_of - 1 year). | |
| series_id | Yes | FRED series id (e.g. UNRATE, CPILFESL, DGS10). See covered list in the description. |