Ameren APIameren.com ↗

"""Walkthrough: Ameren Utility API — electricity prices, outages, and programs."""
from parse_apis.ameren_utility_api import Ameren, State, RateCategory, PriceDataUnavailable

client = Ameren()

# Fetch today's hourly wholesale electricity prices
today_report = client.hourlypricereports.today()
print(f"Today ({today_report.date}): {len(today_report.prices)} hourly prices, next_day={today_report.is_next_day}")

# Look at peak/off-peak price spread from today's data
if today_report.prices:
    for price_entry in today_report.prices[:3]:
        print(f"  Hour {price_entry.hour}: ${price_entry.price}/kWh")

# Fetch prices for a specific historical date
historical = client.hourlypricereports.get(date="2026-06-09")
print(f"Historical ({historical.date}): {len(historical.prices)} hours")

# Check current outage status across service areas
summary = client.outagesummaries.current()
print(f"Outage data generated at: {summary.generated_at}")
for region in summary.regions:
    print(f"  {region.region_name}: {region.active_outages} outages, {region.customers_affected} affected, {region.percent_active}% available")

# Get rate information for Missouri business customers using enums
rates = client.ratesinfos.get(state=State.MO, category=RateCategory.BUSINESS)
print(f"Rates URL ({rates.state}, {rates.category}): {rates.url}")

# Typed error handling for unavailable price data
try:
    future = client.hourlypricereports.get(date="2099-01-01")
    print(f"Future prices: {future.prices}")
except PriceDataUnavailable as exc:
    print(f"Price data unavailable: {exc}")

print("exercised: hourlypricereports.today / .get / outagesummaries.current / ratesinfos.get / error handling")