FRED Economic Data

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 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).

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 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). Results are sorted most-recent-first. For long series (e.g. daily data since 1954), use start_date/end_date to narrow the window or increase the limit up to 10000. 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'). limit: Maximum observations to return (default 1000, max 10000).

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).