Reference · built on requestCommons signalEnergy & grid

AESO API

Alberta Electric System Operator JSON APIs: hourly pool price, current supply and demand by fuel, Alberta Internal Load, and outages.

About

The AESO API is the Alberta Electric System Operator's public data gateway at developer-apim.aeso.ca, hosted on Azure API Management. It serves JSON for the Alberta Interconnected Electric System: the hourly Pool Price with its forecast and 30-day rolling average, System Marginal Price, Current Supply Demand with generation by fuel type and flows on each interchange path, actual and forecast Alberta Internal Load, generation capacity and outages, load outage forecasts, intertie reports, the energy merit order, and metered volumes.

On Fibric, an operator reads the pool price and the current supply picture, weighs them against your site's flexible load or battery, and proposes a shift or a charge window for your approval.

This is a reference listing. It documents what Fibric would read from AESO API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Pool Price Report v1.1: pool_price, forecast_pool_price, and rolling_30day_avg per settlement hour in CAD, from 2000-01-01
  • Current Supply Demand v2: alberta_internal_load, total_net_generation, net_actual_interchange, contingency reserves, generation_data_list by fuel_type, and interchange_list by path
  • Actual Forecast Report v1: alberta_internal_load and forecast_alberta_internal_load per hour under /load/albertaInternalLoad
  • System Marginal Price Report v1.1, Energy Merit Order Report, and Operating Reserve Offer Control Report
  • AIES Gen Capacity API for generation capacity and outages, and Load Outage Forecast API for load outages submitted to the AESO
  • Intertie Public Reports, Metered Volume Report, Asset List, Pool Participant, and Unit Commitment Data APIs

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Shift load off a high pool price hour

    Read the Pool Price Report each hour, including forecast_pool_price for the coming hours. When the price crosses your threshold, the operator proposes shifting flexible load and records the settlement hour behind it.

    With Price Shift

  • Charge a battery on the current supply picture

    Poll the Current Supply Demand summary for generation by fuel type and interchange flows. The operator proposes a charge or discharge window that fits the price and supply picture, for your approval.

    With Battery Dispatch

  • Compare site demand with Alberta Internal Load

    Pull actual and forecast Alberta Internal Load for the week. The operator lines it up with your own demand plan and proposes where to move deferrable work, with the forecast rows attached.

    With Demand Outlook, Peak Demand

Requirements

  • An account on developer-apim.aeso.ca, confirmed by email, with a subscription to the AESO Public API product
  • Acceptance of the AESO terms of use at subscription; AESO's website terms permit non-commercial, personal, or educational use
  • Date ranges in yyyy-MM-dd for the report endpoints; startDate is required and endDate optional
Authentication
A free API key. You register on the developer portal, subscribe to the AESO Public API product, and send the primary or secondary key in an API-KEY header.

Limits

  • Date-range reports such as Pool Price return at most 1 year per request
  • Current Supply Demand returns only the latest snapshot, stamped with its effective time
  • AESO's website terms restrict use to non-commercial, personal, or educational purposes without written permission
  • If AESO drops and recreates a product, existing keys stop working and you must regenerate them

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request AESO API ↗

Questions and answers

Is the API key free?
Yes. AESO's instructions say you sign up with an email, confirm it, subscribe to the AESO Public API product, and primary and secondary keys appear on your profile page. Requests carry the key in an API-KEY header. AESO answers questions at info@aeso.ca.
How much history does the Pool Price Report return?
Any date between 2000-01-01 and the current date, in yyyy-MM-dd. The endDate is optional; if you omit it you get the completed settlement hours of startDate. The API returns at most 1 year per request. Values are strings in CAD.
What do AESO's terms allow?
AESO's legal page permits use and copying of material for non-commercial, personal, or educational purposes, unmodified and with copyright notices kept. Other uses need AESO's written permission. AESO does not guarantee accuracy, currency, or completeness.
Ask about AESO API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.