---
id: gridstatus
version: "0.36.0"
license: Copyright 2022 James Max Kanter Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of… (full text in the JSON record)
license_treatment: unclear
maintenance: active
---

# gridstatus — API to access energy data

License: unclear · Maintenance: active · Downloads: 93.7K/mo

## What it is and what it does

gridstatus is a Python library that normalizes access to electricity market data across multiple Independent System Operators in North America. It abstracts away the different data formats and APIs that each ISO publishes, presenting a consistent interface for fetching supply, demand, and pricing information. The library depends on pandas for data manipulation, requests for HTTP access, and several parsing libraries (beautifulsoup4, lxml, pdfplumber, openpyxl, xlrd) to handle the variety of data formats ISOs publish—some as APIs, others as web-scraped pages or file downloads.

The package is maintained by Grid Status and actively developed (last release 2026-04-21, last commit 2026-08-13). It is designed for research, analysis, and integration into energy market monitoring tools. The documentation notes that this library provides minimally-processed raw data; for production use cases, the maintainers recommend their hosted API instead. Installation is straightforward and requires Python 3.10 or higher.

Use it for:

- Fetch real-time or historical electricity demand and supply data from a specific ISO for market analysis
- Build a monitoring dashboard that aggregates pricing data across multiple ISOs for comparison
- Integrate grid status data into an energy trading or forecasting model
- Analyze historical load patterns and pricing trends across North American electricity markets
- Scrape and normalize electricity data for research or academic energy studies

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

gridstatus provides a unified Python API to fetch raw electricity supply, demand, and pricing data from major US and Canadian Independent System Operators (ISOs) including CAISO, SPP, ISONE, MISO, ERCOT, NYISO, PJM, IESO, AESO, and EIA.

Yes, if you need programmatic access to raw electricity market data from US or Canadian ISOs and can handle minimally-processed data. The library is actively maintained, has low install friction, and covers a wide range of ISOs. However, for production systems requiring guaranteed uptime and data quality, the maintainers recommend their hosted GridStatus.io API instead. License is permissive (BSD 3-Clause) and no known vulnerabilities are recorded.

## Install

pip install gridstatus
uv add gridstatus
poetry add gridstatus

## Installing gridstatus

Before you install: Low friction install with a pure-Python wheel. Active maintenance (last commit 2026-08-13) and 439 GitHub stars. Requires Python 3.10+ and supports current versions. Some parsers require environment variables for API credentials.

License in practice: BSD 3-Clause license (unclear SPDX classification in metadata). Permits commercial and private use with attribution and liability disclaimer; derivative works allowed under same terms.

Quickstart:

pip install gridstatus

import gridstatus

# Fetch CAISO data
data = gridstatus.CAISO().get_load()

Requires Python 3.10 or higher. Some ISO parsers require environment variables for authentication or API access (see .env.template in repository).

Verify before relying:

- Whether all 10 supported ISOs are equally well-maintained and have current data coverage
- Latency and update frequency for real-time data from each ISO
- Rate limits or throttling policies for data access
- Whether production use should prefer the hosted GridStatus.io API over this library

## Package facts

- License: Copyright 2022 James Max Kanter Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 93.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

electricity market data api, iso grid data python, caiso miso ercot data, power grid pricing data, energy supply demand data, independent system operator api, real-time electricity data, grid status data access, energy-data, market-data, grid-monitoring

[View on SkillFed](https://skillfed.io/packages/gridstatus) · [View on PyPI](https://pypi.org/project/gridstatus/)