Documentation

Build on the grid intelligence platform

Everything you need to integrate GridMind AI into your grid operations — from quick start to production deployment.

API Reference → Get Support

Quick Start

Get your first demand forecast running in under 10 minutes. You'll need an API key from the GridMind dashboard and at least 30 days of historical meter data.

1. Install the SDK

pip install gridmind-sdk
# or
npm install @gridmind/sdk

2. Initialize the client

import gridmind from '@gridmind/sdk'

const client = new gridmind.Client({
  apiKey: process.env.GRIDMIND_API_KEY,
  region: 'us-west-2',
});

3. Run your first forecast

const forecast = await client.forecast.create({
  gridId: 'grid-eu-west-01',
  horizon: '72h',
  resolution: '15min',
  features: ['weather', 'market', 'historical'],
});

console.log(forecast.predictions); // 288 data points

The response includes demand predictions in MW, uncertainty intervals at 80% and 95% confidence, and renewable generation forecasts for each 15-minute window in your horizon.

Authentication

All GridMind API requests require Bearer token authentication. API keys are scoped to either read-only (forecasting) or read-write (optimization commands) permissions.

Authorization: Bearer gm_live_xxxxxxxxxxxxxxxxxxxx

Keys are rotatable without downtime via the dashboard. We recommend rotating production keys every 90 days and using environment variables — never hardcoding credentials.