seds

State Energy Data System (SEDS): annual state-level energy estimates back to 1960.

Examples

from openbb import obb
# Total energy consumption per capita for Texas.
obb.eia.seds(provider='eia', series='total_energy_consumption_per_capita', state='texas')

Parameters

• standard
• eia

series: str | None | list[str | None]
Unique series identifier filter. Accepts a comma-separated list of values. There are 968 valid values - use the facet_options endpoint to list them. Multiple items allowed.

state: str | None | list[str | None]
State name filter. Accepts a comma-separated list of values. Multiple items allowed.

Choices

• alabama
• alaska
• arizona
• arkansas
• california
• colorado
• connecticut
• delaware
• district_of_columbia
• federal_offshore_gulf_of_america
• federal_offshore_pacific
• florida
• georgia
• hawaii
• idaho
• illinois
• indiana
• iowa
• kansas
• kentucky
• louisiana
• maine
• maryland
• massachusetts
• michigan
• minnesota
• mississippi
• missouri
• montana
• nebraska
• nevada
• new_hampshire
• new_jersey
• new_mexico
• new_york
• north_carolina
• north_dakota
• ohio
• oklahoma
• oregon
• pennsylvania
• rhode_island
• south_carolina
• south_dakota
• tennessee
• texas
• united_states
• utah
• vermont
• virginia
• washington
• west_virginia
• wisconsin
• wyoming

start_date: date | None | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | None | str
End date of the data, in YYYY-MM-DD format.

sort: str | None
Default: asc
Sort the results by date.

limit: int | None
Maximum number of rows to return. The default returns all rows, paginating requests as needed.

---

Returns

results: EiaSeds

Serializable results.

provider: str | None

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• eia

series: str | None
Unique series identifier code.

series_name: str | None
Unique series identifier name.

state: str | None
State name code.

state_name: str | None
State name name.

value: float | None
Value. Withheld or unavailable values return as null.

unit: str | None
Unit of the value.

date: date | datetime | str
Start of the period the record covers. Hourly frequencies return a timestamp.