openbb-us-eia
The U.S. Energy Information Administration is committed to its free and open data by making it available through an Application Programming Interface (API) and its open data tools. See https://www.eia.gov/opendata/ for more information.
Decision gist · record as of 2026-08-14
Yes, if you are already using the OpenBB Platform and need access to official U.S. energy data. The package is actively maintained, has low install friction, and provides access to authoritative EIA datasets. However, the AGPL-3.0 license restricts use in proprietary closed-source projects, and you must obtain a free EIA API key to use most endpoints. Not suitable as a standalone library—it is a provider extension for OpenBB.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a free EIA API key from https://www.eia.gov/opendata/register.php; most endpoints require this credential to function.
- Low install friction with a pure Python wheel and four runtime dependencies.
- Active maintenance with a release within the last 80 days.
License · maintenance · safety
AGPL-3.0-only (agpl) — Licensed under AGPL-3.0-only, which requires derivative works and modifications to be distributed under the same license and made available to users. Suitable for internal or open-source projects but not for proprietary closed-source applications.
last release 2026-05-26 (80 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 81,694 downloads/mo, #14,207 on PyPI
Alternatives
Verify before relying
pip install openbb-us-eia
from openbb import obb
obb.user.credentials.eia_api_key = "YOUR_API_KEY"
data = obb.commodity.petroleum_status_report(table="balance_sheet")- Whether the package works as a standalone tool or only within the full OpenBB Platform ecosystem.
- Performance characteristics and data freshness guarantees for real-time or near-real-time energy market queries.
- Whether all 13 WPSR categories and 10b STEO tables are fully implemented or if some remain in development.
What it is and what it does
This package extends the OpenBB Platform with a provider for U.S. Energy Information Administration data, enabling programmatic access to two main datasets: the Weekly Petroleum Status Report (WPSR) and the Short Term Energy Outlook (STEO). The WPSR covers 13 high-level petroleum categories including production, stocks, imports, and prices, sourced from EIA's static Excel files. The STEO provides forecasted energy market data across multiple tables covering oil, natural gas, coal, electricity, and macroeconomic indicators.
The package requires registration with EIA to obtain a free API key, which can be configured via the OpenBB Hub, a JSON settings file, or programmatically in the current session. Data is returned in a flat, tabular format suitable for pivot tables and SQL storage. The petroleum status report does not require an API key, while most STEO endpoints do.
Use it for
- Retrieve weekly petroleum supply and inventory data for energy market analysis and reporting.
- Access short-term energy forecasts across oil, gas, coal, and electricity sectors for investment or policy decisions.
- Build automated dashboards or reports that pull the latest EIA data into OpenBB-based applications.
- Query historical petroleum prices and regional energy data for quantitative energy market research.
- Integrate U.S. energy market data into financial models or trading systems via the OpenBB Platform.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are already using the OpenBB Platform and need access to official U.S.
energy data. The package is actively maintained, has low install friction, and provides access to authoritative EIA datasets. However, the AGPL-3.0 license restricts use in proprietary closed-source projects, and you must obtain a free EIA API key to use most endpoints. Not suitable as a standalone library—it is a provider extension for OpenBB.
Install
openbb-us-eia on PyPI
Before you install
Low install friction with a pure Python wheel and four runtime dependencies. Active maintenance with a release within the last 80 days. Supports current Python versions (3.10–3.14).
Requires a free EIA API key from https://www.eia.gov/opendata/register.php; most endpoints require this credential to function.
License in practice
Licensed under AGPL-3.0-only, which requires derivative works and modifications to be distributed under the same license and made available to users. Suitable for internal or open-source projects but not for proprietary closed-source applications.
Quickstart
pip install openbb-us-eia
from openbb import obb
obb.user.credentials.eia_api_key = "YOUR_API_KEY"
data = obb.commodity.petroleum_status_report(table="balance_sheet")Verify before relying
- Whether the package works as a standalone tool or only within the full OpenBB Platform ecosystem.
- Performance characteristics and data freshness guarantees for real-time or near-real-time energy market queries.
- Whether all 13 WPSR categories and 10b STEO tables are fully implemented or if some remain in development.
Package facts
| License | AGPL-3.0-only agpl |
| Python support | Supports the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesasync-lruopenbb-coreopenpyxlxlrd |
| Maintenance | Actively maintained 80 days since the last release |
| First released | |
| Downloads | 81,694 / month, #14,207 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: GNU Affero General Public License v3Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: openbb_us_eia-1.3.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “EIA energy data API”
- openbb-us-eiaIntegrates U.S. Energy Information Administration (EIA) data into the…
- ovoenergyA Python client library for querying energy consumption and account…
- energyquantifiedA Python client library for querying Energy Quantified's time series…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also openbb-tradingeconomics · opower · gridstatus · openbb-econdb · openbb-benzinga · openbb-bls · openbb-economy · openbb-tiingo · entsoe-py · amberelectric