fred-economic-data

Fetch FRED economic time series and metadata via a unified Python client.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Hung-3008/agusta --skill fred-economic-data-hung-3008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fred-economic-data
Source: https://github.com/Hung-3008/agusta/tree/main/.agents/skills/fred-economic-data
Command: npx skills add https://github.com/Hung-3008/agusta --skill fred-economic-data-hung-3008

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The FRED data access and query workflow lets analysts retrieve a vast suite of U.S. and international macroeconomic indicators from the FRED API, enabling faster research and informed decision-making.

Core Features & Use Cases

  • Unified Python client to fetch series metadata, observations, vintage data, releases, categories, tags, sources, and GeoFRED regional data.
  • Supports searching, filtering by keywords, tags, and categories, plus regional mapping and regional data aggregation.
  • Real-world use: build dashboards or research datasets by programmatically pulling GDP, unemployment, CPI, interest rates, and regional indicators for a chosen date range.

Quick Start

Run a basic query to fetch GDP observations using the FREDQuery client.

Frequently Asked Questions about fred-economic-data

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

FAQPage Schema
How do I fetch FRED economic time series data using Python?

Fetch FRED economic time series data using a unified Python client that retrieves series observations, metadata, and vintage data programmatically. It handles API-key management, optional caching, and retry logic to access 800k+ macroeconomic indicators.

Can I retrieve regional macroeconomic data from GeoFRED for mapping and aggregation?

Yes, retrieve regional macroeconomic data from GeoFRED. The client supports regional mapping and regional data aggregation, allowing you to pull localized indicators for geographic analysis and dashboard building.

What types of FRED API endpoints are supported for macroeconomic analysis?

Supported FRED API endpoints include series, observations, categories, releases, tags, sources, and GeoFRED. You can search and filter by keywords, tags, and categories to build research datasets for macroeconomic forecasting.

Do I need a FRED API key to access observations and series metadata?

Yes, a FRED API key is required. The client implements API-key handling internally to authenticate requests when you retrieve series metadata, vintage data, or observations from the 100+ supported data sources.

What's the best way to filter FRED data by tags and categories for academic research?

Filter FRED data by using the client's search functionality to query by keywords, tags, and categories. This narrows down the 800k+ available time series to build targeted datasets for academic research and forecasting.

Does this client support caching and retry logic for large data retrieval requests?

Yes, the client supports optional caching and retry logic. This optimizes data retrieval when pulling large volumes of economic observations or vintage data across multiple API requests for macroeconomic analysis.