# GridStatus

> GridStatus.io provides real-time and historical electricity-grid data — locational marginal prices (LMP), load, generation and fuel mix, forecasts, interconnection queues, and curated analytics — across North American ISOs (CAISO, ERCOT, MISO, PJM, NYISO, ISO-NE, SPP, IESO, AESO) and the EIA. This manifest points AI agents and LLMs at the platform's machine-readable surfaces so you can reach the API spec, documentation, and account/key issuance without a web search.

## API

- [OpenAPI specification](https://api.gridstatus.io/openapi.json): Complete machine-readable schema for the REST API served at https://api.gridstatus.io/v1. Most endpoints require an API key, passed as the `x-api-key` request header or the `api_key` query parameter.
- [API documentation](https://docs.gridstatus.io/developers): Authentication, pagination, rate limits, error handling, and copy-paste recipes.
- [Get an API key](https://www.gridstatus.io/settings/api): Create and manage API keys for your account.

## Documentation

- [Documentation index (llms.txt)](https://docs.gridstatus.io/llms.txt): Machine-readable index of the full documentation site.
- [Ask the docs](https://docs.gridstatus.io/?ask=): Natural-language RAG search over the documentation. Append a URL-encoded question, e.g. https://docs.gridstatus.io/?ask=How%20do%20I%20query%20day-ahead%20LMP%20data
- [Python client](https://github.com/gridstatus/gridstatusio): The `gridstatusio` Python client for the hosted API.

## Discovery

- [API catalog (RFC 9727)](https://www.gridstatus.io/.well-known/api-catalog): Linkset pointing to the OpenAPI spec and documentation for the REST API.
- [AI plugin manifest](https://www.gridstatus.io/.well-known/ai-plugin.json): Machine-readable capabilities manifest tying together the OpenAPI spec, documentation, and key issuance.
- [Sitemap](https://www.gridstatus.io/sitemap.xml): Index of public site URLs.

## About

- [GridStatus.io](https://www.gridstatus.io): Monitor, analyze, and export power-market data across North American grid operators.