Skip to main content

kardashev

PyPI PyPI Downloads License Python

Open energy data for all US ISOs. Direct access to CAISO, ERCOT, MISO, NYISO, ISONE, SPP, and PJM - no API key, no rate limits, no gridstatus dependency.

Install

pip install kardashev

Direct ISO access (no API key)

from kardashev import CAISO, ERCOT, MISO, NYISO, ISONE, SPP

# CAISO
caiso = CAISO()
df = caiso.get_fuel_mix()           # live generation by fuel type
df = caiso.get_load()               # actual grid load
df = caiso.get_lmp(market="RT")     # real-time LMP (TH_NP15 hub)
df = caiso.get_lmp(market="DA", node="TH_SP15_GEN-APND")
df = caiso.get_curtailment()        # solar + wind curtailment

# ERCOT
ercot = ERCOT()
df = ercot.get_fuel_mix()
rows = ercot.get_lmp(market="RT")   # settlement point prices (CDR)
rows = ercot.get_lmp(market="DA")   # DAM hourly prices

# MISO
miso = MISO()
df = miso.get_fuel_mix()
rows = miso.get_lmp(market="RT")    # 5-min hub prices
rows = miso.get_lmp(market="DA")    # ex-ante DA LMP

# NYISO
nyiso = NYISO()
df = nyiso.get_fuel_mix()
df = nyiso.get_lmp(market="RT")     # real-time zonal LMP
df = nyiso.get_lmp(market="DA")     # day-ahead zonal LMP

# ISONE (LMP requires ISONE_USERNAME + ISONE_PASSWORD env vars)
isone = ISONE()
df = isone.get_fuel_mix()
df = isone.get_lmp(market="RT", location=".Z.NEPOOL")

# SPP
spp = SPP()
df = spp.get_fuel_mix()
df = spp.get_lmp()                  # latest RTBM prices

Managed API (optional)

Use Client to query the Kardashev Labs API - adds carbon intensity, LMP history, interconnection queues, and 25+ more endpoints with a single hosted backend.

from kardashev import Client

kl = Client()

# Live fuel mix for CAISO
fuel = kl.fuel_mix(iso="CAISO")

# Real-time LMP hub prices for MISO
prices = kl.lmp(iso="MISO", market="RT", limit=50)

# Carbon intensity (lbs CO₂/MWh) for ERCOT
carbon = kl.carbon(iso="ERCOT")

# All nodes with latest LMP for the map view
nodes = kl.lmp_map(iso="PJM", market="RT")

Endpoints

Method Description
fuel_mix(iso) Generation by fuel type
carbon(iso) Carbon intensity (lbs CO₂/MWh)
carbon_latest() Latest carbon intensity for all ISOs
lmp(iso, market, node_id, limit) LMP price history
lmp_map(iso, market) All nodes with latest price + coordinates
lmp_hubs(iso) Hub/zone node list
load(iso) Actual grid load
load_forecast(iso) Load forecast
generation(iso) Generation by unit type
curtailment(iso) Renewable curtailment
interchange(iso) Tie-line power flows
nat_gas(hub) Natural gas spot prices
nat_gas_storage() EIA weekly storage report
weather(city) Weather observations
outages(iso) Generator outage reports
ancillary(iso, market) Ancillary service prices
nuclear_status() Nuclear plant capacity factors
emissions(iso) SO₂/NOₓ emission rates
hydro(iso) Hydro generation
solar(iso) Solar generation
queue(iso) Interconnection queue
commodities() Power/gas commodity prices
carbon_markets() RGGI/WCI carbon market prices

ISOs supported

CAISO, ERCOT, ISONE, MISO, NYISO, PJM, SPP

Custom base URL

kl = Client(base_url="https://data.kardashevlabs.org")

License

MIT - see LICENSE.

Metadata

Release files for kardashev 0.2.3

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

Source distribution (sdist)

Source distribution for kardashev 0.2.3
File Size Uploaded
kardashev-0.2.3.tar.gz 29.7 kB Details

Built distribution (wheel)

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

Total release size: 70.2 kB

Release files / kardashev-0.2.3.tar.gz

Download URL kardashev-0.2.3.tar.gz
Size 29.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f4e83701ef5d651b3d3a0e52c7d6128ca7e516c929a647ab15c195190b82e02f
BLAKE2b-256 checksum
How to use checksums
283644ba030594b67f8e92d9071494d754c603cce1a9290e59f12766378d3fc1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.13

Release files / kardashev-0.2.3-py3-none-any.whl

Download URL kardashev-0.2.3-py3-none-any.whl
Size 40.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c17a8e5b6c0adb0e0b6c0ca0f5ac5d1a61f61595851e72d3d914084e7e10cb05
BLAKE2b-256 checksum
How to use checksums
c1e06b40d591616c4dc385a2718776201f30579205594d5e96cc72bad8130c7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.13

Release history Release notifications | RSS feed

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.4

2 release files

This release

0.2.3 This release

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.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