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: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
start_date: date | str
Start date of the data, in YYYY-MM-DD format.
end_date: date | str
End date of the data, in YYYY-MM-DD format.
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']
Default: balance_sheet
The group of data to be returned. The default is the balance sheet.
table: 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
- 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
use_cache: bool
Default: True
Subsequent requests for the same source data are cached for the session using ALRU cache.
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: 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: 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.