AESO

AESO System Marginal Price Report API

The System Marginal Price — the real-time price signal that sets the pool price over each settlement hour — served as JSON both as a historical date-range report and as a current-value endpoint. Two documented operations: /price/systemMarginalPrice for a range and /price/systemMarginalPrice/current for the live value.

GitHub OpenAPI

Documentation

📖
Documentation
https://www.aeso.ca/market/market-and-system-reporting/aeso-application-programming-interface-api/
📖
APIReference
https://developer-apim.aeso.ca/apis

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/aeso/refs/heads/main/openapi/aeso-systemmarginalprice-api-v1-1-openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/aeso/refs/heads/main/overlays/aeso-systemmarginalprice-api-v1-1-overlay.yaml

OpenAPI Specification

aeso-systemmarginalprice-api-v1-1-openapi.json Raw ↑ 
{
  "openapi": "3.0.1",
  "info": {
    "title": "System Marginal Price Report",
    "description": "System Marginal Price report data",
    "version": "v1.1"
  },
  "servers": [
    {
      "url": "https://apimgw.aeso.ca/public/systemmarginalprice-api"
    },
    {
      "url": "https://gateway-apim.aeso.ca/public/systemmarginalprice-api"
    }
  ],
  "paths": {
    "/price/systemMarginalPrice": {
      "get": {
        "operationId": "getSystemMarginalPriceReportForDateRange",
        "summary": "Fetch system marginal price report for a given date range",
        "description": "Fetch system marginal price report for the date range: startDate (yyyy-MM-dd) to endDate (yyyy-MM-dd). The endDate is optional. If omitted, fetched data will include all data up to the last completed SMP value for the startDate. The API will return a maximum of 4,392 hours (i.e. 183 days).\n\n\n**Please note:** This API does not provide the active System Marginal Price (SMP). To obtain the active SMP, please use the 'Fetch the active system marginal price' API in the lefthand pane.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemMarginalPriceDataReport"
                },
                "examples": {
                  "default": {
                    "value": {
                      "System Marginal Price Report": [
                        {
                          "begin_datetime_utc": "string",
                          "end_datetime_utc": "string",
                          "begin_datetime_mpt": "string",
                          "end_datetime_mpt": "string",
                          "system_marginal_price": 0,
                          "volume": "string"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          },
          "405": {
            "description": "Invalid method"
          },
          "500": {
            "description": "Internal server error"
          },
          "503": {
            "description": "Service unavailable"
          }
        },
        "parameters": [
          {
            "name": "startDate",
            "in": "query",
            "required": true,
            "description": "Any date between 2000-01-01 and current date. (format: yyyy-MM-dd).)",
            "schema": {
              "$ref": "#/components/schemas/PriceSystemMarginalPriceGetRequest"
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "required": false,
            "description": "Any date up to current date but after startDate. If left blank, only data for startDate will be returned. (format: yyyy-MM-dd).)",
            "schema": {
              "$ref": "#/components/schemas/PriceSystemMarginalPriceGetRequest-1"
            }
          }
        ]
      }
    },
    "/price/systemMarginalPrice/current": {
      "get": {
        "operationId": "getCurrentSystemMarginalPriceReport",
        "summary": "Fetch the active system marginal price.",
        "description": "Fetch the active system marginal price.",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SystemMarginalPriceDataReport"
                },
                "examples": {
                  "default": {
                    "value": {
                      "System Marginal Price Report": [
                        {
                          "begin_datetime_utc": "string",
                          "end_datetime_utc": "string",
                          "begin_datetime_mpt": "string",
                          "end_datetime_mpt": "string",
                          "system_marginal_price": 0,
                          "volume": "string"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          },
          "405": {
            "description": "Invalid method"
          },
          "500": {
            "description": "Internal server error"
          },
          "503": {
            "description": "Service unavailable"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKeyHeader": {
        "type": "apiKey",
        "name": "API-KEY",
        "in": "header"
      },
      "apiKeyQuery": {
        "type": "apiKey",
        "name": "subscription-key",
        "in": "query"
      }
    },
    "schemas": {
      "SystemMarginalPriceDataReport": {
        "type": "object",
        "properties": {
          "System Marginal Price Report": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SystemMarginalPriceDataVO"
            }
          }
        }
      },
      "SystemMarginalPriceDataVO": {
        "type": "object",
        "properties": {
          "begin_datetime_utc": {
            "type": "string",
            "description": "The begin timestamp of when the block set the SMP, in UTC."
          },
          "end_datetime_utc": {
            "type": "string",
            "description": "The end timestamp of when the block set the SMP, in UTC."
          },
          "begin_datetime_mpt": {
            "type": "string",
            "description": "The begin timestamp of when the block set the SMP, in MPT (Mountain Prevailing Time)."
          },
          "end_datetime_mpt": {
            "type": "string",
            "description": "The end timestamp of when the block set the SMP, in MPT (Mountain Prevailing Time)."
          },
          "system_marginal_price": {
            "type": "number",
            "description": "The offered price of the block that set the SMP, in CAD.",
            "format": "double"
          },
          "volume": {
            "type": "string",
            "description": "The Available MW for the block at the time the block set the SMP."
          }
        }
      },
      "PriceSystemMarginalPriceGetRequest": {
        "pattern": "^\\d{4}\\-(0[1-9]|1[012])\\-(0[1-9]|[12][0-9]|3[01])$",
        "type": "string",
        "x-apim-inline": true
      },
      "PriceSystemMarginalPriceGetRequest-1": {
        "pattern": "^\\d{4}\\-(0[1-9]|1[012])\\-(0[1-9]|[12][0-9]|3[01])$",
        "type": "string",
        "x-apim-inline": true
      }
    }
  },
  "security": [
    {},
    {
      "apiKeyHeader": []
    },
    {
      "apiKeyQuery": []
    }
  ],
  "x-provenance": {
    "harvestedBy": "API Evangelist",
    "harvestedOn": "2026-07-27",
    "sourcePortal": "https://developer-apim.aeso.ca/",
    "method": "Assembled verbatim from the AESO Azure API Management developer-portal data API, which is served anonymously. AESO's own OpenAPI export (?export=true&format=openapi) returns a valid document with an EMPTY paths object, so paths, parameters, responses, examples and component schemas were read from the portal's operations/ and schemas/ endpoints and reassembled without alteration. Nothing was invented.",
    "sources": [
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1?api-version=2022-04-01-preview",
        "status": 200,
        "note": "API metadata"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1?export=true&format=openapi%2Bjson&api-version=2022-04-01-preview",
        "status": 200,
        "note": "AESO OpenAPI export (empty paths) - basis for info/servers/security"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1/operations?api-version=2022-04-01-preview",
        "status": 200,
        "note": "operation list"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1/schemas?api-version=2022-04-01-preview",
        "status": 200,
        "note": "schema list"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1/operations/getSystemMarginalPriceReportForDateRange?api-version=2022-04-01-preview",
        "status": 200,
        "note": "operation detail"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1/operations/getCurrentSystemMarginalPriceReport?api-version=2022-04-01-preview",
        "status": 200,
        "note": "operation detail"
      },
      {
        "url": "https://developer-apim.aeso.ca/developer/apis/systemmarginalprice-api-v1-1/schemas/675b18ad3d594b1e2075ef16?api-version=2022-04-01-preview",
        "status": 200,
        "note": "schema document"
      }
    ]
  }
}