Skip to main content

gridstatus logo

Code Coverage PyPI version

gridstatus is a Python library that provides a uniform API for accessing electricity supply, demand, and pricing data for the major Independent System Operators (ISOs) in the United States. It currently supports data from CAISO, SPP, ISONE, MISO, ERCOT, NYISO, PJM, IESO, and the EIA.

GridStatus.io and Hosted API

To preview some of the data this library provides access to, visit GridStatus.io.

If you are trying to use our hosted API, you might want to check out the gridstatusio library here.

To learn more about our hosted API visit: https://www.gridstatus.io/api.

Community

Installation

gridstatus supports python 3.9+. Install with pip

python -m pip install gridstatus

Upgrade using the following command

python -m pip install --upgrade gridstatus

Environment Variables

  • Some parsers require the use of environment variables
    • The EIA class
    • The ErcotAPI class
  • Environment variables can be set in the following ways
    • In a .env file in the root of the project
    • In the environment where the code is run
  • See .env.template for the required environment variables and how to register for them

Documentation and Examples

To learn more, visit the documentation and view example notebooks.

Get Help

We'd love to answer any usage or data access questions! Please let us know by posting a GitHub issue.

Metadata

Release files for gridstatus 0.28.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gridstatus 0.28.0
File Size Uploaded
gridstatus-0.28.0.tar.gz 289.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for gridstatus 0.28.0
File Interpreter ABI Platform
gridstatus-0.28.0-py3-none-any.whl Python 3 none any Details

Total release size: 601.9 kB

Release files / gridstatus-0.28.0.tar.gz

Download URL gridstatus-0.28.0.tar.gz
Size 289.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c6ab4bc577ffd613dc99ab4608839ff97d91573c73b88be0823affcb32ff10f8
BLAKE2b-256 checksum
How to use checksums
4b72bcb10c68cd9ce2865055b53b807c81f976764599dba343ddeb6346ed2c39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Release files / gridstatus-0.28.0-py3-none-any.whl

Download URL gridstatus-0.28.0-py3-none-any.whl
Size 312.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9a1fc5ffc30809909b41c9b0e625ddadc0c913a63a4eff90a375ddb049c14dcb
BLAKE2b-256 checksum
How to use checksums
9509bc0e34fb6c9bfcd92ba3302834121e66c87e9cc6e4b69f3907dc7a03a517
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.1.1 CPython/3.12.7

Release history Release notifications | RSS feed

0.36.0

2 release files

0.35.0

2 release files

0.34.0

2 release files

0.33.0

2 release files

0.31.0

2 release files

0.30.1

2 release files

0.29.1

2 release files

0.29.0

2 release files

This release

0.28.0 This release

2 release files

0.26.0

2 release files

0.24.0

2 release files

0.23.0

2 release files

0.21.0

2 release files

0.20.0

2 release files

0.19.0

2 release files

0.18.0

2 release files

0.17.0

2 release files

0.16.0

2 release files

0.12.0

2 release files

0.11.0

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page