> ## Documentation Index
> Fetch the complete documentation index at: https://docs.powersignals.co.za/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> South African power-market infrastructure for AI agents and developers.

# Power Signals API

Power Signals provides real-time, structured energy data through a clean, predictable REST API. We are a **primary-source data provider** of Eskom grid data — every system-state reading is collected, parsed, and served by us directly.

We ingest data the moment it is published, normalise it into machine-ready formats, and expose it via API. Data is typically available within seconds of publication. All timestamps are returned in UTC; see [Data Provenance](/guides/data-provenance) for details.

## What You Can Access

Our underlying coverage spans **2,400+ generation, transmission, and distribution assets** with **5+ years** of history. The API currently exposes grid-level signals derived from this coverage at hourly resolution; per-asset endpoints are on the roadmap. Available datasets today:

* **Grid System State** — Hourly residual demand, imports/exports, total renewable generation, and derived grid metrics (renewable share, OCGT ramp, forecast error).
* **Generation Mix** — Per-fuel-type generation (coal, nuclear, gas, hydro, wind, solar PV, CSP, pumped storage) as a standalone dataset.
* **Grid Stress Index** — A derived signal indicating overall grid stress level, computed from system-state data.

### Coming soon

* **System Demand Forecasts** — Day-ahead and intraday forecast demand.
* **Loadshedding** — Eskom stage announcements, area schedules, and historical time-series.
* **SAPP Day-Ahead Prices** — Hourly clearing prices (ZAR), volumes, and revision history.
* **NERSA Filings** — MYPD submissions, tariff decisions, and licensing records.

## Built For

* AI energy-market agents and LLM pipelines
* Quantitative research desks and trading firms
* IPP developers and project-finance analysts
* Grid operators, regulators, and demand-response platforms
* Risk, policy, and sustainability researchers

## Design Principles

The API follows four principles:

1. **Primary source** — We collect directly from official sources (currently Eskom; SAPP and NERSA coming soon).
2. **Cleanly typed** — All responses follow a consistent `meta` + `data` envelope.
3. **Version-stable** — Breaking changes only happen on major version bumps.
4. **Never silent** — If a feed upstream is late, the API returns a structured `data_delay` response instead of stale values.