gridstatus

Provides standardized API to access energy data from the major Independent System Operators in the United States.
https://github.com/gridstatus/gridstatus

Category: Energy Systems
Sub Category: Energy Data Accessibility and Integration

Keywords

co2-emissions decarbonization electrical-grid energy python

Keywords from Contributors

archiver transforms measur optimize animals projection generic compose observation conversion

Last synced: about 10 hours ago
JSON representation

Repository metadata

Extract data from ISOs and other energy grid sources

• Host: GitHub
• URL: https://github.com/gridstatus/gridstatus
• Owner: gridstatus
• License: bsd-3-clause
• Created: 2022-07-28T19:24:20.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2026-08-03T03:53:39.000Z (12 days ago)
• Last Synced: 2026-08-10T13:57:31.153Z (5 days ago)
• Topics: co2-emissions, decarbonization, electrical-grid, energy, python
• Language: Python
• Homepage: https://opensource.gridstatus.io
• Size: 14.1 MB
• Stars: 439
• Watchers: 8
• Forks: 84
• Open Issues: 40
• Releases: 38
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Citation: CITATION.cff

README.md

uv pip install gridstatus
# or
pip install gridstatus

from gridstatus import CAISO, Ercot, SPP, list_isos

# See the ISO classes exposed by the discovery helper
list_isos()

# Pick an ISO and pull a dataset for a fixed date
iso = Ercot()
fuel_mix = iso.get_fuel_mix("2024-06-01")

# Source-specific methods expose other datasets and market intervals
ercot_lmp = Ercot().get_lmp_by_settlement_point("2024-06-01")
spp_lmp = SPP().get_lmp_real_time_5_min_by_location("2024-06-01")
real_time_15_min_lmp = CAISO().get_lmp_real_time_15_min("2024-06-01")
day_ahead_hourly_lmp = CAISO().get_lmp_day_ahead_hourly("2024-06-01")

print(fuel_mix.head())

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: gridstatus
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Max
    family-names: Kanter
    email: max@gridstatus.io
    affiliation: Grid Status
repository-code: 'https://github.com/gridstatus/gridstatus'
url: 'https://opensource.gridstatus.io/en/latest/'
abstract: >-
  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.
keywords:
  - energy
  - electricity
  - grid
  - python
  - data
license: BSD-3-Clause
version: 0.36.0
date-released: 2026-04-20

Owner metadata

• Name: gridstatus
• Login: gridstatus
• Email:
• Kind: organization
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/111189335?v=4
• Repositories: 1
• Last ynced at: 2023-05-04T20:40:43.121Z
• Profile URL: https://github.com/gridstatus

GitHub Events

Total

• Release event: 4
• Delete event: 218
• Pull request event: 412
• Fork event: 23
• Issues event: 27
• Watch event: 74
• Issue comment event: 199
• Push event: 1281
• Pull request review comment event: 651
• Pull request review event: 825
• Create event: 266

Last Year

• Delete event: 75
• Pull request event: 93
• Fork event: 5
• Issues event: 3
• Watch event: 13
• Issue comment event: 31
• Push event: 359
• Pull request review event: 170
• Pull request review comment event: 123
• Create event: 97

Committers metadata

Last synced: 1 day ago

Committer domains:

• gridstatus.io: 3
• usu.edu: 1
• vel9.com: 1
• sbcglobal.net: 1
• djc.me: 1
• cornell.edu: 1
• brianstrauch.com: 1
• apache.org: 1
• advmicrogrid.com: 1

Issue and Pull Request metadata

Last synced: 1 day ago

Package metadata

• Total packages: 2
• Total downloads:
  • pypi: 80,538 last-month
• Total dependent packages: 1 (may contain duplicates)
• Total dependent repositories: 1 (may contain duplicates)
• Total versions: 41
• Total maintainers: 1

Dependencies

Score: 21.229422363623556