short_term_energy_outlook
Monthly short term (18 month) projections using EIA's STEO model.
Source: www.eia.gov/steo/
Examples
from openbb import obb
# Get the EIA's Short Term Energy Outlook.
obb.commodity.short_term_energy_outlook(provider='eia')
# Select the specific table of data from the STEO. Table 03d is World Crude Oil Production.
obb.commodity.short_term_energy_outlook(table=03d, provider='eia')
Parameters
- standard
- eia
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
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
symbol: Union[str, list[str]]
Symbol to get data for. If provided, overrides the 'table' parameter to return only the specified symbol from the STEO API. Multiple items allowed for provider(s): eia.
• Optional: True
table: Literal['01', '02', '03a', '03b', '03c', '03d', '03e', '04a', '04b', '04c', '04d', '05a', '05b', '06', '07a', '07b', '07c', '07d1', '07d2', '07e', '08', '09a', '09b', '09c', '10a', '10b']
Description
The specific table within the STEO dataset. Default is '01'. When 'symbol' is provided, this parameter is ignored.
01: US Energy Markets Summary
02: Nominal Energy Prices
03a: World Petroleum and Other Liquid Fuels Production, Consumption, and Inventories
03b: Non-OPEC Petroleum and Other Liquid Fuels Production
03c: World Petroleum and Other Liquid Fuels Production
03d: World Crude Oil Production
03e: World Petroleum and Other Liquid Fuels Consumption
04a: US Petroleum and Other Liquid Fuels Supply, Consumption, and Inventories
04b: US Hydrocarbon Gas Liquids (HGL) and Petroleum Refinery Balances
04c: US Regional Motor Gasoline Prices and Inventories
04d: US Biofuel Supply, Consumption, and Inventories
05a: US Natural Gas Supply, Consumption, and Inventories
05b: US Regional Natural Gas Prices
06: US Coal Supply, Consumption, and Inventories
07a: US Electricity Industry Overview
07b: US Regional Electricity Retail Sales
07c: US Regional Electricity Prices
07d1: US Regional Electricity Generation, Electric Power Sector
07d2: US Regional Electricity Generation, Electric Power Sector, continued
07e: US Electricity Generating Capacity
08: US Renewable Energy Consumption
09a: US Macroeconomic Indicators and CO2 Emissions
09b: US Regional Macroeconomic Data
09c: US Regional Weather Data
10a: Drilling Productivity Metrics
10b: Crude Oil and Natural Gas Production from Shale and Tight Formations
• Default: 01
• Optional: True
frequency: Literal['month', 'quarter', 'annual']
The frequency of the data. Default is 'month'.
• Default: month
• Optional: True
Returns
results: list[ShortTermEnergyOutlook]
Serializable results.
provider: Optional[Literal['eia']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- eia
date: Union[date, str]
The date of the data.
table: str
Table name for the data.
symbol: str
Symbol representing the entity requested in the data.
order: int
Presented order of the data, relative to the table.
title: str
Title of the data.
value: Union[int, float]
Value of the data.
unit: str
Unit or scale of the data.
date: Union[date, str]
The date of the data.
table: str
Table name for the data.
symbol: str
Symbol representing the entity requested in the data.
order: int
Presented order of the data, relative to the table.
title: str
Title of the data.
value: Union[int, float]
Value of the data.
unit: str
Unit or scale of the data.