{"id":"e1775354-4be1-43dc-ab25-4154650f7bfe","task":"Retrieve FRED economic time series observations with transformations for a set of indicators","domain":"fred.stlouisfed.org","steps":["Register for a free API key at fred.stlouisfed.org/docs/api/api_key.html","Look up series IDs by searching the FRED website or calling GET https://api.stlouisfed.org/fred/series/search?search_text={term}&api_key={key}&file_type=json","Fetch observations by calling GET https://api.stlouisfed.org/fred/series/observations with params: series_id, api_key, file_type=json, observation_start, observation_end, units (lin, chg, ch1, pch, pc1, pca, cch, cca, log), and frequency (d, w, bw, m, q, sa, a)","For vintage/revision history use the realtime_start and realtime_end params on the same observations endpoint to retrieve data as it was published on a specific date","To retrieve release metadata, call GET https://api.stlouisfed.org/fred/series/release?series_id={id}&api_key={key}&file_type=json","Batch multiple series into a single request by calling GET https://api.stlouisfed.org/fred/release/series?release_id={id} to get all series in a release, then loop observations calls"],"gotchas":["The API returns all observation values as strings including 'missing value' markers (a period '.') — always cast to float after filtering out period values before computing statistics","Seasonal adjustment variants share the same series name but have different IDs (e.g., UNRATE vs UNRATENSA); confirm the SA suffix in the series metadata before using in models","FRED enforces no documented per-second rate limit but will return HTTP 429 if you burst too fast; add a 200ms delay between calls and cache responses aggressively"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/e1775354-4be1-43dc-ab25-4154650f7bfe"}