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).
输入参数limitsearch_text必填
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).
输入参数limitend_dateseries_id必填start_date
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').
输入参数series_id必填
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).
输入参数category_id必填
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).
输入参数release_id必填
