fred_regional
Query the Geo Fred API for regional economic data by series group.
The series group ID is found by using fred_search and the series_id parameter.
Parameters
- standard
- fred
symbol: str
Symbol to get data for.
• Optional: False
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: int
The number of data entries to return.
• Default: 100000
• Optional: True
symbol: str
For this function, it is the series_group ID or series ID. If the symbol provided is for a series_group, set the is_series_group parameter to True. Not all series that are in FRED have geographical data.
• Optional: False
start_date: Union[date, str]
Start date of the data, in YYYY-MM-DD format.
• Optional: True
end_date: Union[date, str]
End date of the data, in YYYY-MM-DD format.
• Optional: True
limit: int
The number of data entries to return.
• Default: 100000
• Optional: True
is_series_group: bool
When True, the symbol provided is for a series_group, else it is for a series ID.
• Default: False
• Optional: True
region_type: Literal['bea', 'msa', 'frb', 'necta', 'state', 'country', 'county', 'censusregion']
The type of regional data. Parameter is only valid when is_series_group is True.
• Optional: True
season: Literal['sa', 'nsa', 'ssa']
The seasonal adjustments to the data. Parameter is only valid when is_series_group is True.
• Default: nsa
• Optional: True
units: str
The units of the data. This should match the units returned from searching by series ID. An incorrect field will not necessarily return an error. Parameter is only valid when is_series_group is True.
• Optional: True
frequency: Literal['a', 'q', 'm', 'w', 'd', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem']
Description
Frequency aggregation to convert high frequency data to lower frequency.
None = No change
a = Annual
q = Quarterly
m = Monthly
w = Weekly
d = Daily
wef = Weekly, Ending Friday
weth = Weekly, Ending Thursday
wew = Weekly, Ending Wednesday
wetu = Weekly, Ending Tuesday
wem = Weekly, Ending Monday
wesu = Weekly, Ending Sunday
wesa = Weekly, Ending Saturday
bwew = Biweekly, Ending Wednesday
bwem = Biweekly, Ending Monday
• Optional: True
aggregation_method: Literal['avg', 'sum', 'eop']
Description
A key that indicates the aggregation method used for frequency aggregation.
This parameter has no affect if the frequency parameter is not set.
avg = Average
sum = Sum
eop = End of Period
• Default: eop
• Optional: True
transform: Literal['chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log']
Description
Transformation type
None = No transformation
chg = Change
ch1 = Change from Year Ago
pch = Percent Change
pc1 = Percent Change from Year Ago
pca = Compounded Annual Rate of Change
cch = Continuously Compounded Rate of Change
cca = Continuously Compounded Annual Rate of Change
log = Natural Log
• Optional: True
Returns
results: list[FredRegional]
Serializable results.
provider: Optional[Literal['fred']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- fred
date: Union[date, str]
The date of the data.
date: Union[date, str]
The date of the data.
region: str
The name of the region.
code: Union[str, int]
The code of the region.
value: Union[float, int]
The obersvation value. The units are defined in the search results by series ID.
series_id: str
The individual series ID for the region.