Retrieve FRED economic time series observations with transformations for a set of indicators

domain: fred.stlouisfed.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register for a free API key at fred.stlouisfed.org/docs/api/api_key.html
  2. 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
  3. 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)
  4. 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
  5. To retrieve release metadata, call GET https://api.stlouisfed.org/fred/series/release?series_id={id}&api_key={key}&file_type=json
  6. 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

Known gotchas

Related routes

Retrieve economic time series data from FRED using the St. Louis Fed API
fred.stlouisfed.org · 5 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans