petroleum_status_report
EIA Weekly Petroleum Status Report.
Examples
from openbb import obb
# Get the EIA's Weekly Petroleum Status Report.
obb.commodity.petroleum_status_report(provider='eia')
# Select the category of data, and filter for a specific table within the report.
obb.commodity.petroleum_status_report(category=weekly_estimates, table=imports, 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
category: Literal['balance_sheet', 'inputs_and_production', 'refiner_blender_net_production', 'crude_petroleum_stocks', 'gasoline_fuel_stocks', 'total_gasoline_by_sub_padd', 'distillate_fuel_oil_stocks', 'imports', 'imports_by_country', 'weekly_estimates', 'spot_prices_crude_gas_heating', 'spot_prices_diesel_jet_fuel_propane', 'retail_prices']
The group of data to be returned. The default is the balance sheet.
• Default: balance_sheet
• Optional: True
table: Union[str, list[str]]
Description
The specific table element within the category to be returned, default is 'stocks', if the category is 'weekly_estimates', else 'all'.
Note: Choices represent all available tables from the entire collection and are not all available for every category.
Invalid choices will raise a ValidationError with a message indicating the valid choices for the selected category.
Choices are:
all
conventional_gas
crude
crude_production
crude_production_avg
diesel
ethanol_plant_production
ethanol_plant_production_avg
exports
exports_avg
heating_oil
imports
imports_avg
imports_by_country
imports_by_country_avg
inputs_and_utilization
inputs_and_utilization_avg
jet_fuel
monthly
net_imports_inc_spr_avg
net_imports_incl_spr
net_production
net_production_avg
net_production_by_product
net_production_by_production_avg
product_by_region
product_by_region_avg
product_supplied
product_supplied_avg
propane
rbob
refiner_blender_net_production
refiner_blender_net_production_avg
stocks
supply
supply_avg
ulta_low_sulfur_distillate_reclassification
ulta_low_sulfur_distillate_reclassification_avg
weekly Multiple items allowed for provider(s): eia.
Choices
allconventional_gascrudecrude_productioncrude_production_avgdieselethanol_plant_productionethanol_plant_production_avgexportsexports_avgheating_oilimportsimports_avgimports_by_countryimports_by_country_avginputs_and_utilizationinputs_and_utilization_avgjet_fuelmonthlynet_imports_inc_spr_avgnet_imports_incl_sprnet_productionnet_production_avgnet_production_by_productnet_production_by_production_avgproduct_by_regionproduct_by_region_avgproduct_suppliedproduct_supplied_avgpropanerbobrefiner_blender_net_productionrefiner_blender_net_production_avgstockssupplysupply_avgulta_low_sulfur_distillate_reclassificationulta_low_sulfur_distillate_reclassification_avgweekly
• Optional: True
use_cache: bool
Subsequent requests for the same source data are cached for the session using ALRU cache.
• Default: True
• Optional: True
Returns
results: list[PetroleumStatusReport]
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.