EXAIOS › Developers
API · Developers

EXAIOS Indication API

A free, deterministic, AI-callable endpoint. From annual consumption and region it returns a conservative verdict on whether PV, storage or a hybrid pays off — plus key figures and a reproducible hash.

When an agent should call this: when a task needs a fast, defensible first number on the economics of PV / storage / PV+storage at a site. No registration. Free to cite.

Endpoint

GET https://exaios.com/api/indication

Rate limit: 100 indications per day per IP. Not a bankable result and not a design basis — the bankable run is the paid product.

Parameters

NameRequiredTypeDescription
annual_kwhyesnumberAnnual electricity consumption in kWh.
regionnostringPostcode / region / country code, e.g. DE-BY, 71154, TR.
project_typenoenumoptional hint: pv · pv_bess · bess
budget_eurnonumberOptional CapEx budget cap in EUR.

Example

curl "https://exaios.com/api/indication?annual_kwh=850000&region=71154&project_type=pv_bess"

Response (shape):

{
  "ampel": "LOHNT_SICH" | "GRENZFALL" | "LOHNT_SICH_NICHT",
  "kpis": { "amortisation_years": ..., "jahresgewinn_eur": ..., "lebens_multiplikator": ... },
  "recommended_architecture": "PV+BESS",
  "confidence": "low (indication only — not bankable)",
  "spec_hash": "…",
  "full_report_url": "https://exaios.com/upgrade/?kwh=…&h=…",
  "powered_by": "EXAIOS — exaios.com"
}

Machine-readable

OpenAPI 3 specification: /openapi.json. AI read-map: /llms.txt · /llms-full.txt.