Get Supply Surplus
get_supply_surplusRetrieve official AESO hourly supply surplus status observations, including zero-price forecast states, to assess market and grid conditions.
Instructions
Returns official AESO hourly Supply Surplus status observations. Zero-price states are forecasts/statuses; they are not inferred from observed Pool Price.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request": "<request>"
},
"name": "get_supply_surplus"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request | Yes | Optional filter for the current supply-surplus status publication. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | Pagination state for a stable in-memory report result. | |
| metadata | Yes | Provenance and semantic metadata attached to dataset responses. | |
| warnings | No | ||
| intervals | Yes |