Skip to main content
GET
/
api
/
v1
/
features
/
grid-stress
Get grid stress index
curl --request GET \
  --url https://api.powersignals.co.za/api/v1/features/grid-stress \
  --header 'X-API-KEY: <api-key>'
{
  "meta": {
    "start": "<string>",
    "end": "<string>",
    "dataset": "features.grid_stress_index",
    "feature": "grid_stress_index",
    "version": "v1",
    "interval": "1h",
    "timezone": "UTC",
    "schema_version": "1.0",
    "derived": true,
    "derivation_method": "computed_from_grid.system_state"
  },
  "data": [
    {}
  ]
}

​
Overview

The Grid Stress Index is a derived signal that indicates the overall stress level of the South African power grid at any given hour. It is computed from multiple system state factors including residual demand, OCGT ramp rates, renewable penetration, and reserve margins.

​
Interpretation

Value RangeMeaning
0.0 – 0.3Low stress — grid operating comfortably
0.3 – 0.6Moderate stress — elevated demand or reduced reserves
0.6 – 0.8High stress — potential for loadshedding
0.8 – 1.0Critical — loadshedding likely or active

​
Components

Each data point includes a components object breaking down the factors contributing to the stress score: 
{
  "ts": "2026-01-01T18:00:00Z",
  "value": 0.72,
  "components": {
    "residual_demand": 0.8,
    "ocgt_ramp": 0.6,
    "reserve_margin": 0.75,
    "renewable_shortfall": 0.65
  },
  "version": "v1"
}

​
Use Cases

  • Trigger alerts when grid stress exceeds a threshold
  • Correlate grid stress with market prices
  • Power demand-response automation
  • Feed into energy trading models

Authorizations

​
X-API-KEY
string
header
required

API key obtained from the Power Signals dashboard.

Query Parameters

​
components
boolean

Include the components breakdown for each stress score. Defaults to false.

​
end
string
required

End datetime in ISO-8601 format.

​
interval
enum<string>

Data resolution. Only 1h is currently supported.

Available options:
1h
​
start
string
required

Start datetime in ISO-8601 format.

Response

​
meta
object
required
​
data
object[]
required