API Documentation¶
All API calls map the raw REST api as closely as possible, including the distinction between required and optional arguments to the calls. This means that the code makes distinction between positional and keyword arguments; we, however, recommend that people use keyword arguments for all calls for consistency and safety.
Fred¶
-
class
fred.
Fred
(api_key='abcdefghijklmnopqrstuvwxyz123456', response_type='xml')[source]¶ Fred client. Provides a straightforward mapping from Python to FRED REST endpoints. The instance has attributes
cateogry
,release
,series
,tag
andsource
that provide access to instances offred.clients.categories.CategoriesClient
,fred.clients.releases.ReleasesClient
,fred.clients.eseries.ESeriesClient
,fred.clients.tags.TagsClient
andfred.clients.sources.SourcesClient
respectively. This is the preferred (and only supported) way to get access to those classes and their methods.Parameters:
Categories¶
-
class
fred.clients.categories.
CategoriesClient
(client, api_key, url_root, response_type)[source]¶ Class for working with FRED categories
-
children
(*args, **kwargs)[source]¶ Function to request a particular category’s children https://research.stlouisfed.org/docs/api/fred/category_children.html
Parameters: - category_id (int) – The id for a category. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
-
details
(*args, **kwargs)[source]¶ Function to request a particular category’s high-level details https://research.stlouisfed.org/docs/api/fred/category.html
Parameters:
Function to request a particular category’s related categories. Related categories are A related category is a one-way relation between 2 categories that is not part of a parent-child category hierarchy. Most categories do not have related categories. https://research.stlouisfed.org/docs/api/fred/category_related.html
Parameters: - category_id (int) – The id for a category. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
Function to request FRED related tags for a particular category. FRED tags are attributes assigned to series. Series are assigned tags and categories. Indirectly through series, it is possible to get the tags for a category. No tags exist for a category that does not have series. https://research.stlouisfed.org/docs/api/fred/category_tags.html
Parameters: - category_id (int) – The id for a category. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- tag_names (str) – Tag names that series match. Required. Separate with semicolon as in “income;bea”
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- exclude_tag_names (str) – Tag names to exclude. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’
-
series
(*args, **kwargs)[source]¶ Function to request a particular category’s data series https://research.stlouisfed.org/docs/api/fred/category_series.html
Parameters: - category_id (int) – The id for a category. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- filter_variable (str) – The attribute to filter results by. Options are ‘frequency’, ‘units’,’seasonal_adjustment’
- filter_value (str) – The value of the filter_variable attribute to filter results by.
- tag_names (str) – Tag names used to match series. Separate with semicolon as in “income;bea”
- exclude_tag_names (str) – Tag names used to exclude series. Separate with semicolon as in “income;bea”
Function to request a particular category’s FRED tags. FRED tags are attributes assigned to series. Series are assigned tags and categories. Indirectly through series, it is possible to get the tags for a category. No tags exist for a category that does not have series. https://research.stlouisfed.org/docs/api/fred/category_tags.html
Parameters: - category_id (int) – The id for a category. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- tag_names (str) – Tag names to only include in the response. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’
-
Releases¶
-
class
fred.clients.releases.
ReleasesClient
(client, api_key, url_root, response_type)[source]¶ Class for working with FRED releases
-
all_dates
(*args, **kwargs)[source]¶ Function to request release dates for all releases of economic data. https://research.stlouisfed.org/docs/api/fred/releases_dates.html
Parameters: - response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘release_date’, ‘release_id’, ‘release_name’.
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- include_release_dates_with_no_data (str) – Determines whether release dates with no data available are returned. Options are ‘true’, ‘false’
-
all_releases
(*args, **kwargs)[source]¶ Function to request all releases of economic data. https://research.stlouisfed.org/docs/api/fred/releases.html
Parameters: - response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘release_id’, ‘name’, ‘press_release’, ‘realtime_start’, ‘realtime_end’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
-
dates
(*args, **kwargs)[source]¶ Function to request release dates for a particular release of economic data. Note that release dates are published by data sources and do not necessarily represent when data will be available on the FRED or ALFRED websites. https://research.stlouisfed.org/docs/api/fred/release_dates.html
Parameters: - release_id (int) – The id for a release. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- sort_order (str) – Sort results is ascending or descending release date order. Options are ‘asc’,’desc’
- include_release_dates_with_no_data (str) – Determines whether release dates with no data available are returned. Options are ‘true’, ‘false’
-
details
(*args, **kwargs)[source]¶ Function to request the high-level details for a particular release of economic data.. https://research.stlouisfed.org/docs/api/fred/release.html
Parameters: - release_id (int) – The id for a release. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
Function to request FRED related tags for a particular release. FRED tags are attributes assigned to series. Series are assigned tags and releases. Indirectly through series, it is possible to get the tags for a category. No tags exist for a release that does not have series. https://research.stlouisfed.org/docs/api/fred/release_related_tags.html
Parameters: - release_id (int) – The id for a release. Required.
- tag_names (str) – Tag names that series match. Separate with semicolon as in “income;bea”. Required
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- exclude_tag_names (str) – Tag names to exclude. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’
-
series
(*args, **kwargs)[source]¶ Function to request the series on a release of economic data. https://research.stlouisfed.org/docs/api/fred/release_series.html
Parameters: - release_id (int) – The id for a release. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- filter_variable (str) – The attribute to filter results by. Options are ‘frequency’, ‘units’,’seasonal_adjustment’
- filter_value (str) – The value of the filter_variable attribute to filter results by.
- tag_names (str) – Tag names used to match series. Separate with semicolon as in “income;bea”
- exclude_tag_names (str) – Tag names used to exclude series. Separate with semicolon as in “income;bea”
-
sources
(*args, **kwargs)[source]¶ Function to request the sources for a particular release of economic data. https://research.stlouisfed.org/docs/api/fred/release.html
Parameters: - release_id (int) – The id for a release. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
Function to request FRED tags for a particular release. FRED tags are attributes assigned to series. Series are assigned tags and releases. Indirectly through series, it is possible to get the tags for a category. No tags exist for a release that does not have series. https://research.stlouisfed.org/docs/api/fred/release_tags.html
Parameters: - release_id (int) – The id for a release. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- tag_names (str) – Tag names that series match. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’
-
Series¶
-
class
fred.clients.eseries.
ESeriesClient
(client, api_key, url_root, response_type)[source]¶ Class for working with FRED series
-
categories
(*args, **kwargs)[source]¶ Function to request the categories for an economic data series. https://research.stlouisfed.org/docs/api/fred/release.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
-
details
(*args, **kwargs)[source]¶ Function to request a series of economic data. https://research.stlouisfed.org/docs/api/fred/release.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
-
observations
(*args, **kwargs)[source]¶ Function to request the observations or data values for an economic data series. https://research.stlouisfed.org/docs/api/fred/series_observations.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 100000
- offset (int) – Data offset. Options >=0
- sort_order (str) – Sort results is ascending or descending observation_date order. Options are ‘asc’,’desc’
- observation_start (str) – The start of the observation period. Format “YYYY-MM-DD”
- observation_end (str) – The end of the observation period. Format “YYYY-MM-DD”
- units (str) – A key that indicates a data value transformation. Options are ‘lin’, ‘chg’, ‘ch1’, ‘pch’, ‘pc1’, ‘pca’, ‘cch’, ‘cca’, ‘log’
- frequency (str) – Indicates a lower frequency to aggregate values. Options are ‘d’, ‘w’, ‘bw’, ‘m’, ‘q’, ‘sa’, ‘a’, ‘wef’, ‘weth’, ‘wew’, ‘wetu’, ‘wem’, ‘wesu’, ‘wesa’, ‘bwew’, ‘bwem’
- aggregation_method (str) – Indicates the aggregation method used for frequency aggregation. Options are ‘avg’, ‘sum’, ‘eop’
- output_type (int) – Output type. Options are 1, 2, 3, 4
- vintage_dates (str) – Date(s) in history. Format “YYYY-MM-DD”. Example for multiple dates “2000-01-01,2005-02-24,...”
-
release
(*args, **kwargs)[source]¶ Function to request the release for an economic data series. https://research.stlouisfed.org/docs/api/fred/series_release.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
-
search
(*args, **kwargs)[source]¶ Function to request economic data series that match search text. https://research.stlouisfed.org/docs/api/fred/series_search.html
Parameters: - search_text (str) – The words to match against economic data series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- search_type (str) – Determines the type of search to perform. Options are ‘full_text’,’series_id’
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘search_rank’, ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- filter_variable (str) – The attribute to filter results by. Options are ‘frequency’, ‘units’,’seasonal_adjustment’
- filter_value (str) – The value of the filter_variable attribute to filter results by.
- tag_names (str) – Tag names used to match series. Separate with semicolon as in “income;bea”
- exclude_tag_names (str) – Tag names used to exclude series. Separate with semicolon as in “income;bea”
Function to request the related FRED tags for one or more FRED tags matching a series search. https://research.stlouisfed.org/docs/api/fred/series_search_related_tags.html
Parameters: - series_search_text (str) – The words to match against economic data series. Required.
- tag_names (str) – Tag names that series match. Separate with semicolon as in “income;bea”. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- tag_search_text (str) – The words to find matching tags with.
- exclude_tag_names (str) – Tag names to exclude. Separate with semicolon as in “income;bea”
Function to request the FRED tags for a series search. https://research.stlouisfed.org/docs/api/fred/series_search_tags.html
Parameters: - series_search_text (str) – The words to match against economic data series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- tag_names (str) – Tag names that series match. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- tag_search_text (str) – The words to find matching tags with.
Function to request FRED tags for a particular series. FRED tags are attributes assigned to series. https://research.stlouisfed.org/docs/api/fred/series_tags.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
-
updates
(*args, **kwargs)[source]¶ Function to request economic data series sorted by when observations were updated on the FRED server (attribute last_updated). Results are limited to series updated within the last two weeks. https://research.stlouisfed.org/docs/api/fred/series_updates.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- filter_value (str) – Limit results by geographic type of economic data series. Options are ‘macro’, ‘regional’, and ‘all’
-
vintage_dates
(*args, **kwargs)[source]¶ Function to request the dates in history when a series’ data values were revised or new data values were released. Vintage dates are the release dates for a series excluding release dates when the data for the series did not change. https://research.stlouisfed.org/docs/api/fred/series_vintagedates.html
Parameters: - series_id (int) – The id for a series. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- sort_order (str) – Sort results by vintage_date. Options are ‘asc’,’desc’
-
Sources¶
-
class
fred.clients.sources.
SourcesClient
(client, api_key, url_root, response_type)[source]¶ Class for working with FRED sources
-
details
(*args, **kwargs)[source]¶ Function to request a particular source of economic data. https://research.stlouisfed.org/docs/api/fred/source.html
Parameters: - source_id (int) – The id for a source. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
-
releases
(*args, **kwargs)[source]¶ Function to request all releases of economic data. https://research.stlouisfed.org/docs/api/fred/releases.html
Parameters: - source_id (int) – The id for a source. Required.
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘source_id’, ‘name’, ‘realtime_start’, ‘realtime_end’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
-
sources
(*args, **kwargs)[source]¶ Function to request all sources of economic data. https://research.stlouisfed.org/docs/api/fred/sources.html
Parameters: - response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘source_id’, ‘name’, ‘realtime_start’, ‘realtime_end’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
-
Tags¶
Class for working with FRED tags
Function to request FRED related tags. FRED tags are attributes assigned to series. https://research.stlouisfed.org/docs/api/fred/related_tags.html
Parameters: - tag_names (str) – Tag names that series match. Required. Separate with semicolon as in “income;bea”
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- exclude_tag_names (str) – Tag names to exclude. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’
Function to request series matching all tags in the tag_names parameter. https://research.stlouisfed.org/docs/api/fred/category_series.html
Parameters: - tag_names (str) – Tag names that series match. Required. Separate with semicolon as in “income;bea”
- response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_id’, ‘title’, ‘units’, ‘frequency’, ‘seasonal_adjustment’, ‘realtime_start’, ‘realtime_end’, ‘last_updated’, ‘observation_start’, ‘observation_end’, ‘popularity’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- exclude_tag_names (str) – Tag names used to exclude series. Separate with semicolon as in “income;bea”
Function to request FRED tags. FRED tags are attributes assigned to series. https://research.stlouisfed.org/docs/api/fred/tags.html
Parameters: - response_type (str) – File extension of response. Options are ‘xml’, ‘json’, ‘dict’,’df’,’numpy’,’csv’,’tab,’pipe’. Required.
- realtime_start (str) – The start of the real-time period. Format “YYYY-MM-DD”
- realtime_end (str) – The end of the real-time period. Format “YYYY-MM-DD”
- limit (int) – The maximum number of results to return. Options 1 to 1000
- offset (int) – Data offset. Options >=0
- order_by (str) – Order results by values of the specified attribute. Options are ‘series_count’, ‘popularity’, ‘created’, ‘name’, ‘group_id’
- sort_order (str) – Sort results for attribute values specified by order_by. Options are ‘asc’,’desc’
- tag_names (str) – Tag names to only include in the response. Separate with semicolon as in “income;bea”
- tag_group_id (str) – Tag ID to filter tags by. Options are ‘freq’, ‘gen’, ‘geo’, ‘geot’, ‘rls’, ‘seas’, ‘src’
- search_text (str) – The words to find matching tags with. For example ‘mortgage rates’