Grid Stress Index

Returns the Grid Stress Index for the given time range. This is a derived signal computed from grid system state data, indicating overall grid stress level. Only 1h interval is supported.

GET /api/v1/features/grid-stress

Get grid stress index

cURL

curl --request GET \
  --url https://api.powersignals.co.za/api/v1/features/grid-stress \
  --header 'X-API-KEY: <api-key>'

200

{
  "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 Range	Meaning
0.0 – 0.3	Low stress — grid operating comfortably
0.3 – 0.6	Moderate stress — elevated demand or reduced reserves
0.6 – 0.8	High stress — potential for loadshedding
0.8 – 1.0	Critical — 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

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

200

application/json

meta · object · required

Show child attributes

data · object[] · required

Show child attributes