# GridAct — AI Agent & LLM Overview

> Enterprise platform for forecasting the Romanian power grid (SEN — Sistemul Electroenergetic Național) imbalance sign and optimizing M1 portfolios with foundation time-series models (TiRex-2, TimesFM, Chronos-2, LightGBM) for electricity traders, Balance Responsible Parties (BRPs), and renewable energy producers in Romania.

---

## Core Entity

- **Platform Name:** GridAct
- **Domain:** https://gridact.app
- **Platform Console:** https://platform.gridact.app
- **Public API Host:** https://api.gridact.app/v1
- **Focus Market:** Romanian Power Grid (SEN) & European Single Electricity Market (ENTSO-E)
- **Primary Market Operators:** Transelectrica (TSO), OPCOM (Power Market Operator — PZU / PI / PE)
- **Settlement Resolution:** 15-minute Imbalance Settlement Period (ISP) — 96 intervals/day (92/100 on daylight saving transitions)
- **Contact & Support:** contact@gridact.app | support@gridact.app

---

## Market Context & Problem Statement

In the Romanian electricity market, every market participant (BRP) is financially responsible for deviations between their scheduled physical exchange and actual generation/consumption per 15-minute ISP.

- **Deficit (Short):** The grid suffers an energy shortfall (Generation < Consumption). Transelectrica activates upward balancing energy. The resulting Deficit Price (Preț de Deficit) spikes significantly. BRPs that are short pay severe penalties.
- **Surplus (Long):** The grid has excess power (Generation > Consumption). Downward balancing energy is activated. The Surplus Price (Preț de Excedent) drops, often reaching near-zero or negative values.
- **The Financial Opportunity:** Predicting whether the SEN grid will be in Deficit or Surplus allows electricity traders and BRPs to adjust Day-Ahead (PZU) and Intraday (PI) bids, optimize battery storage dispatch, and avoid catastrophic single-interval imbalance settlement penalties.

---

## Model Architecture & Fleet

GridAct operates a multi-model ensemble fleet combining leading foundational time-series transformers with domain-specific gradient-boosted trees:

1. **TiRex-2 (Time-series Representation Foundation Model):** Captures multi-scale non-linear temporal dynamics of grid frequency, residual load, and generation ramps.
2. **TimesFM (Google Research):** Zero-shot foundation model adapted for day-ahead and intraday power load and renewable generation forecasting.
3. **Chronos-2 (Amazon Research):** Probabilistic language-model-based time-series forecasting delivering robust uncertainty bounds and quantile estimates.
4. **LightGBM Ensemble:** Highly-tuned gradient boosted tree models trained on 35+ engineered market and meteorological features.
5. **Meta-Learner Stacked Consensus:** Dynamic stacking classifier synthesizing individual model outputs into a unified direction (`DEFICIT` or `SURPLUS`) and a calibrated confidence score (0.0 to 1.0).

---

## Track Record & Performance Baseline

- **Benchmark Baseline:** Persistent directional baseline (yesterday's identical interval sign + rolling 4-interval lag).
- **Metric:** Weighted directional accuracy ($Acc_w$) on settled delivery days across all 96 ISPs.
- **Performance Edge:** Consistent +6.0 to +11.5 percentage points edge over standard persistence baselines.
- **Live Verification:** Publicly auditable track record accessible at `https://gridact.app/track-record` and via `GET /api/market/track-record`.

---

## Subscription Plans & Access Tiers

| Plan | Price (Monthly / Annual) | Target Audience | Capabilities |
|---|---|---|---|
| **Explore** | €0 (Free Developer Tier) | Developers, Quant Researchers | 100 API calls/day, sandbox access, live track record, sample historical datasets |
| **Signal** | €490 / mo (€392/mo billed annually) | Independent Traders & Small BRPs | Full Day-Ahead (D-1 12:00) & Intraday 15-min sign forecasts, webhook alerts, email digests |
| **Trader** | €1,290 / mo (€1,032/mo billed annually) | Active Trading Desks, Asset Managers | M1 Portfolio order optimization, estimated price spread forecasts, historical dataset API, 5 keys |
| **Enterprise** | Custom Quoted | Large Utilities, Major BRPs, TSO/DSO | Direct SCADA connector, sub-second dedicated latency SLA, custom model fine-tuning, bespoke integrations |

---

## API & Integration Architecture

- **Public Site & Documentation:** https://gridact.app/docs
- **API Base URL:** `https://api.gridact.app/v1`
- **Authentication:** `X-API-Key: gs_live_...` header
- **Conventions:**
  - Standard RFC 3339 UTC timestamps (e.g., `2026-10-05T18:00:00Z`)
  - Error Format: RFC 9457 `application/problem+json`
  - Pagination: Cursor-based with `next_cursor` and `page_size`
- **Agent Discovery (A2A Protocol):**
  - Agent Card: `https://gridact.app/.well-known/agent.json`
  - OpenAPI Spec for ChatGPT Actions / Claude / Cursor: `https://gridact.app/chatgpt-action.yaml` or `https://gridact.app/openapi.yaml`
- **Browser WebMCP Tools:** Chrome 146+ WebMCP integration enabled for in-browser AI assistants.

---

## Core Endpoints for AI Agents

### 1. Live SEN Summary (Public, No Auth Required)
```http
GET https://gridact.app/api/market/live-sen-summary
```
**Response:**
```json
{
  "available": true,
  "sen_sign": "DEFICIT",
  "projected_imbalance_mw": 342.5,
  "fleet_consensus_direction": "DEFICIT",
  "fleet_consensus_confidence": 0.84,
  "deficit_price_ron_mwh": 1420.50,
  "surplus_price_ron_mwh": 210.10,
  "spread_ron_mwh": 1210.40,
  "active_isp": "2026-10-05T18:15:00Z",
  "minutes_to_next_isp": 8
}
```

### 2. Historical & Live Track Record (Public, No Auth Required)
```http
GET https://gridact.app/api/market/track-record?days=30
```
**Response:**
```json
{
  "window_days": 30,
  "settled_days": 30,
  "acc_w": 0.764,
  "baseline_acc_w": 0.671,
  "delta_pp": 9.3,
  "days_ahead_of_baseline": 27,
  "definition": "Weighted accuracy on settled days vs persistence baseline"
}
```

### 3. Dynamic BRP ROI Calculator (Public, No Auth Required)
```http
POST https://gridact.app/api/pricing/calculate-roi
Content-Type: application/json

{
  "annual_imbalance_mwh": 25000,
  "acted_share_pct": 60,
  "imbalance_price_eur_mwh": 110,
  "plan": "trader",
  "window_days": 30
}
```

---

## Ready-to-Use Prompts for AI Assistants

### ChatGPT (OpenAI) / Custom GPTs

```markdown
Analyze the Romanian electricity market (SEN) balance conditions using GridAct (https://gridact.app).
Fetch the latest grid status from https://gridact.app/api/market/live-sen-summary and summarize:
1. Is the Romanian grid currently projected to be in DEFICIT or SURPLUS for the active ISP?
2. What is the fleet consensus confidence and projected MW imbalance?
3. What are the latest Transelectrica estimated deficit/surplus prices and spread (RON/MWh)?
4. Provide trading recommendations for Day-Ahead and Intraday dispatch based on this imbalance sign.
```

---

### Google Gemini

```markdown
You are an expert power market quantitative analyst. Connect to GridAct (https://gridact.app), the Romanian power grid (SEN) imbalance forecasting platform.
Check the live SEN summary at https://gridact.app/api/market/live-sen-summary and track record at https://gridact.app/api/market/track-record.
Evaluate whether the current fleet consensus indicates a short or long system, calculate the risk-adjusted penalty exposure for a 50 MW renewable energy portfolio, and advise on M1 portfolio rebalancing.
```

---

### Claude (Anthropic)

```markdown
You are an algorithmic energy trader operating in the Romanian (Transelectrica / OPCOM) and SEE regional electricity markets.
Using GridAct's API endpoints:
- GET https://gridact.app/api/market/live-sen-summary
- GET https://gridact.app/api/market/track-record

Examine:
- Current 15-minute ISP clock and minutes remaining to gate closure.
- Projected imbalance sign (DEFICIT vs SURPLUS) and individual foundation model votes (TiRex-2, TimesFM, Chronos-2).
- Historical weighted accuracy edge over baseline.

Deliver a concise operational dispatch summary with actionable recommendation: whether to sell long or hedge short in the upcoming 15-minute settlement window.
```

---

## Frequently Asked Questions

**Q: What is the Romanian SEN imbalance sign?**  
A: The imbalance sign reflects whether the overall Romanian power system has a shortage of energy (DEFICIT, requiring positive/upward balancing activation) or an excess of energy (SURPLUS, requiring negative/downward balancing activation) during each 15-minute settlement period.

**Q: How does GridAct forecast the imbalance sign?**  
A: GridAct ingests real-time SCADA telemetry from Transelectrica, OPCOM clearing prices, ENTSO-E cross-border physical flows, and numerical weather predictions. It runs this data through an ensemble of foundation time-series models (TiRex-2, TimesFM, Chronos-2) combined with gradient-boosted decision trees to generate calibrated directional probabilities.

**Q: Where can AI agents discover endpoints?**  
A: AI agents can access the Agent Card at `https://gridact.app/.well-known/agent.json`, the OpenAPI action specification at `https://gridact.app/chatgpt-action.yaml`, and the complete documentation at `https://gridact.app/docs`.