# WattShift Documentation

> WattShift developer documentation for API keys, authentication, price signals, impact calculations, utility rate data, and the OpenAPI contract.

## Start Here

- [Quickstart](https://docs.wattshift.com/docs/get_started/quickstart.md): Build a first API flow from API key to utility lookup, home creation, and price signal retrieval.
- [Get API keys](https://docs.wattshift.com/docs/get_started/get-api-keys.md): Get sandbox and production credentials through the partner dashboard flow.
- [Authentication](https://docs.wattshift.com/docs/get_started/authentication.md): Send authenticated POST requests with the `x-ws-api-key` header.

## Core APIs

- [Price signals](https://docs.wattshift.com/docs/optimize_shifts_calculate_impacts/price_signal.md): Request optimized price signals for onboarded homes and devices.
- [Impact calculations](https://docs.wattshift.com/docs/optimize_shifts_calculate_impacts/impact_calculations.md): Calculate bill cost, grid-services revenue, and carbon impact from interval usage.
- [Utility rate data](https://docs.wattshift.com/api-reference/endpoint/utility/list-utilities.md): Look up a known utility by EIA utility ID, or discover utilities and rate plans for a ZIP code, latitude/longitude, or selected market.

## API Contracts

- [OpenAPI JSON](https://docs.wattshift.com/openapi.json): Machine-readable OpenAPI contract for endpoint discovery and client generation.