search_series
Search for FRED economic data series by keyword.
Use this to find series IDs for economic indicators. For example,
search 'unemployment rate' to find UNRATE, or 'gross domestic product'
to find GDP. Returns series metadata including ID, title, frequency,
units, and date range.
Common series: UNRATE (unemployment), GDP (gross domestic product),
CPIAUCSL (consumer price index), FEDFUNDS (federal funds rate),
MORTGAGE30US (30-year mortgage rate), MEHOINUSA672N (median household income).
Args:
search_text: Keywords to search for (e.g. 'unemployment rate', 'GDP', 'inflation').
limit: Maximum number of results to return (default 10, max 1000).
get_series_observations
Get time series observations (data points) for a FRED series.
Returns the actual data values for an economic indicator over time.
Use search_series first to find the series_id, or use well-known IDs
like UNRATE, GDP, CPIAUCSL, FEDFUNDS, MORTGAGE30US.
For state unemployment, use state abbreviation + 'UR' (e.g. WAUR for
Washington, CAUR for California).
Args:
series_id: FRED series identifier (e.g. 'UNRATE', 'GDP', 'CPIAUCSL').
start_date: Optional start date in YYYY-MM-DD format (e.g. '2020-01-01').
end_date: Optional end date in YYYY-MM-DD format (e.g. '2024-12-31').
get_series_info
Get metadata and details for a specific FRED series.
Returns comprehensive information about a series including its title,
frequency, units, seasonal adjustment, source, and date range. Use this
to understand what a series measures before pulling observations.
Args:
series_id: FRED series identifier (e.g. 'UNRATE', 'GDP', 'CPIAUCSL').
get_category_series
Get all FRED series within a specific category.
FRED organizes data into a hierarchy of categories. Use this to browse
available series within a topic area. Common category IDs:
- 32991: Money, Banking, & Finance
- 10: Population, Employment, & Labor Markets
- 32992: National Accounts (GDP)
- 1: Production & Business Activity
- 32455: Prices (CPI, PPI)
- 97: Housing
Args:
category_id: FRED category identifier (integer).
get_release_dates
Get release dates for a specific FRED data release.
Returns the dates when a particular data release was published. Useful
for tracking when economic indicators are updated. Common release IDs:
- 10: Consumer Price Index
- 46: Producer Price Index
- 50: Employment Situation (jobs report)
- 53: Gross Domestic Product
- 17: Federal Reserve H.15 (interest rates)
- 21: Federal Reserve H.6 (money stock)
Args:
release_id: FRED release identifier (integer).