fred-economic-data

Query FRED and GeoFRED economic data through a unified API client.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/BKZhao/MIMIC-Papers-Repro-Agent --skill fred-economic-data-bkzhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fred-economic-data
Source: https://github.com/BKZhao/MIMIC-Papers-Repro-Agent/tree/main/.codex/skills/fred-economic-data
Command: npx skills add https://github.com/BKZhao/MIMIC-Papers-Repro-Agent --skill fred-economic-data-bkzhao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill centralizes access to FRED data—covering 800,000+ time series and ALFRED vintages—so researchers can programmatically fetch series metadata, observations, releases, tags, categories, and regional data for macroeconomic analysis.

Core Features & Use Cases

  • Unified FREDQuery client for series, observations, releases, categories, tags, vintages, and GeoFRED data.
  • Quick-start examples and runnable scripts to retrieve GDP, unemployment, CPI, and regional data for macroeconomic analysis, forecasting, and research.
  • Use cases include building dashboards, reproducible analyses, data pipelines, and educational demonstrations of U.S. and international indicators.

Quick Start

Run scripts/fred_examples.py to exercise GDP data retrieval and regional queries using a valid FRED_API_KEY.

Frequently Asked Questions about fred-economic-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve FRED economic time series data like GDP or unemployment for analysis?

You retrieve FRED economic time series data by running the provided scripts with a valid FRED_API_KEY, which queries series metadata and observations for indicators like GDP, CPI, and unemployment. The unified FREDQuery client handles API requests, retry logic, and optional caching automatically.

What macroeconomic data categories are available through the FRED API endpoints?

The FRED API provides access to series, observations, releases, tags, categories, vintagedates, and GeoFRED regional data endpoints. This covers over 800,000 domestic and international macroeconomic time series for analysis and forecasting.

Do I need a FRED API key to query macroeconomic indicators and regional data?

Yes, you need a valid FRED_API_KEY to query macroeconomic indicators and regional data. The skill implements API key handling within its unified client to authenticate requests across all FRED and GeoFRED endpoints.

Can I fetch ALFRED vintagedates for historical macroeconomic time series analysis?

Yes, you can fetch ALFRED vintagedates for historical macroeconomic time series analysis using the dedicated vintagedates endpoint methods. The skill centralizes access to ALFRED vintages alongside standard FRED series for reproducible research across data revisions.

What's the best way to access GeoFRED regional data for economic indicators programmatically?

The best way to access GeoFRED regional data programmatically is using this skill's unified FREDQuery client, which provides dedicated methods for regional data endpoints. It handles request retries and optional caching to streamline fetching regional economic indicators.

Does the FRED data client support caching and retry logic for time-series requests?

Yes, the FRED data client supports optional caching and retry logic for time-series requests. These features are built into the unified API client to ensure reliable data retrieval when fetching large volumes of macroeconomic observations.