Electricity Market & Grid Intelligence API Documentation

POSThttps://www.brainiac.software/api/v1/electricity-market/price-series-normalize$0.04 USDC

Normalize electricity price series

Normalize caller-supplied electricity market prices with explicit units and timestamps. Missing prices are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "normalized",
  "pointCount": 2,
  "items": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "priceSupplied": true,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "priceSupplied": true,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/price-series-normalize" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "product": "day-ahead",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/price-compare$0.04 USDC

Compare electricity market prices

Compare average and latest electricity prices across supplied markets or regions. Missing values are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 91,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    },
    {
      "id": "P4",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 88.4,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "compared",
  "marketCount": 2,
  "overallAverage": 85,
  "overallAverageSupplied": true,
  "items": [
    {
      "marketKey": "epex",
      "market": "EPEX",
      "region": "DE",
      "observationCount": 2,
      "averagePrice": 89.7,
      "averagePriceSupplied": true,
      "latestPrice": 88.4,
      "latestPriceSupplied": true,
      "latestAt": "2026-11-02T12:00:00.000Z",
      "currency": "EUR",
      "unit": "currency/MWh",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "marketKey": "n2ex",
      "market": "N2EX",
      "region": "GB",
      "observationCount": 2,
      "averagePrice": 80.3,
      "averagePriceSupplied": true,
      "latestPrice": 82.1,
      "latestPriceSupplied": true,
      "latestAt": "2026-11-02T12:00:00.000Z",
      "currency": "GBP",
      "unit": "currency/MWh",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/price-compare" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 91,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    },
    {
      "id": "P4",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 88.4,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/demand-profile-analyze$0.04 USDC

Analyze electricity demand profiles

Analyze supplied demand observations for average, peak, minimum, and load factor by region. Missing megawatts are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "demand": [
    {
      "id": "D1",
      "region": "GB",
      "at": "2026-11-01T18:00:00.000Z",
      "mw": 38500,
      "source": "Caller-supplied"
    },
    {
      "id": "D2",
      "region": "GB",
      "at": "2026-11-01T04:00:00.000Z",
      "mw": 27200,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "regionCount": 1,
  "items": [
    {
      "region": "GB",
      "observationCount": 2,
      "averageMw": 32850,
      "averageMwSupplied": true,
      "peakMw": 38500,
      "peakMwSupplied": true,
      "minMw": 27200,
      "minMwSupplied": true,
      "loadFactor": 0.8532,
      "loadFactorSupplied": true,
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/demand-profile-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "demand": [
    {
      "id": "D1",
      "region": "GB",
      "at": "2026-11-01T18:00:00.000Z",
      "mw": 38500,
      "source": "Caller-supplied"
    },
    {
      "id": "D2",
      "region": "GB",
      "at": "2026-11-01T04:00:00.000Z",
      "mw": 27200,
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/carbon-intensity-track$0.04 USDC

Track grid carbon intensity

Track supplied carbon intensity points, optionally supplemented by the key-free Carbon Intensity API when requested.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "carbon": [
    {
      "id": "C1",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "intensity": 181,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    },
    {
      "id": "C2",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "intensity": 165,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "tracked",
  "pointCount": 2,
  "averageIntensity": 173,
  "averageIntensitySupplied": true,
  "items": [
    {
      "id": "C1",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "intensity": 181,
      "intensitySupplied": true,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "C2",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "intensity": 165,
      "intensitySupplied": true,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied",
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/carbon-intensity-track" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "carbon": [
    {
      "id": "C1",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "intensity": 181,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    },
    {
      "id": "C2",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "intensity": 165,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/bill-tariff-reconcile$0.05 USDC

Reconcile electricity bills to tariffs

Reconcile billed totals to tariff-implied energy, demand, and fixed charges using only supplied rates and quantities.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "energyRate": 0.14,
      "fixedCharge": 120,
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "unit": "currency/kWh",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "kwh": 12000,
      "peakKw": 95,
      "billedEnergy": 1680,
      "billedDemand": 807.5,
      "billedFixed": 120,
      "billedTotal": 2607.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "reconciled",
  "billCount": 1,
  "items": [
    {
      "billId": "BL-1",
      "tariffId": "TF-1",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "kwh": 12000,
      "kwhSupplied": true,
      "peakKw": 95,
      "peakKwSupplied": true,
      "expectedEnergy": 1680,
      "expectedEnergySupplied": true,
      "expectedDemand": 807.5,
      "expectedDemandSupplied": true,
      "expectedFixed": 120,
      "expectedFixedSupplied": true,
      "expectedTotal": 2607.5,
      "expectedTotalSupplied": true,
      "billedTotal": 2607.5,
      "billedTotalSupplied": true,
      "variance": 0,
      "varianceSupplied": true,
      "currency": "GBP",
      "billingAccuracyClaimed": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/bill-tariff-reconcile" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "energyRate": 0.14,
      "fixedCharge": 120,
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "unit": "currency/kWh",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "kwh": 12000,
      "peakKw": 95,
      "billedEnergy": 1680,
      "billedDemand": 807.5,
      "billedFixed": 120,
      "billedTotal": 2607.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/peak-demand-charge-calculate$0.03 USDC

Calculate peak demand charges

Calculate peak-demand charges from supplied peak kW and tariff peakDemandRate values. Missing inputs are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "peakKw": 95,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "calculated",
  "itemCount": 1,
  "items": [
    {
      "billId": "BL-1",
      "tariffId": "TF-1",
      "peakKw": 95,
      "peakKwSupplied": true,
      "peakDemandRate": 8.5,
      "peakDemandRateSupplied": true,
      "peakDemandCharge": 807.5,
      "peakDemandChargeSupplied": true,
      "currency": "GBP",
      "demandUnit": "kW",
      "billingAccuracyClaimed": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/peak-demand-charge-calculate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "peakKw": 95,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/energy-price-volatility-analyze$0.04 USDC

Analyze energy price volatility

Compute historical price and return standard deviations from supplied market price series. Thin samples are reported, not filled.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-03T12:00:00.000Z",
      "price": 80,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "marketCount": 1,
  "items": [
    {
      "marketKey": "n2ex",
      "observationCount": 3,
      "averagePrice": 80.2,
      "averagePriceSupplied": true,
      "priceStdev": 1.8083,
      "priceStdevSupplied": true,
      "returnStdev": 0.0505,
      "returnStdevSupplied": true,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/energy-price-volatility-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-03T12:00:00.000Z",
      "price": 80,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/renewable-generation-forecast$0.05 USDC

Report renewable generation forecasts

Report caller-supplied renewable historical and forecast megawatts, optionally enriched with World Bank renewable series. Future MW are never invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "generation": [
    {
      "id": "G1",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 8200,
      "isForecast": false,
      "source": "Caller-supplied"
    },
    {
      "id": "G2",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-05T12:00:00.000Z",
      "mw": 9100,
      "isForecast": true,
      "source": "Caller-supplied operator forecast"
    },
    {
      "id": "G3",
      "region": "GB",
      "fuel": "solar",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 2100,
      "isForecast": false,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "reported",
  "historicalCount": 2,
  "forecastCount": 1,
  "historicalAverageMw": 5150,
  "historicalAverageMwSupplied": true,
  "forecastInvented": false,
  "items": [
    {
      "id": "G1",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 8200,
      "mwSupplied": true,
      "isForecast": false,
      "source": "Caller-supplied",
      "forecastInvented": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "G3",
      "region": "GB",
      "fuel": "solar",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 2100,
      "mwSupplied": true,
      "isForecast": false,
      "source": "Caller-supplied",
      "forecastInvented": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    },
    {
      "id": "G2",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-05T12:00:00.000Z",
      "mw": 9100,
      "mwSupplied": true,
      "isForecast": true,
      "source": "Caller-supplied operator forecast",
      "forecastInvented": false,
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/renewable-generation-forecast" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "generation": [
    {
      "id": "G1",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 8200,
      "isForecast": false,
      "source": "Caller-supplied"
    },
    {
      "id": "G2",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-05T12:00:00.000Z",
      "mw": 9100,
      "isForecast": true,
      "source": "Caller-supplied operator forecast"
    },
    {
      "id": "G3",
      "region": "GB",
      "fuel": "solar",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 2100,
      "isForecast": false,
      "source": "Caller-supplied"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/grid-outage-public-data-analyze$0.04 USDC

Analyze grid outage public data

Analyze supplied outage notices and optional key-free public feeds by region and customers affected. Missing counts are not invented.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "outages": [
    {
      "id": "O1",
      "region": "North",
      "startedAt": "2026-11-01T08:00:00.000Z",
      "endedAt": "2026-11-01T14:00:00.000Z",
      "customersAffected": 1200,
      "cause": "storm",
      "status": "restored",
      "source": "Caller-supplied utility notice"
    },
    {
      "id": "O2",
      "region": "North",
      "startedAt": "2026-11-03T09:00:00.000Z",
      "customersAffected": 400,
      "cause": "equipment",
      "status": "open",
      "source": "Caller-supplied utility notice"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "analyzed",
  "regionCount": 1,
  "outageCount": 2,
  "regions": [
    {
      "region": "North",
      "outageCount": 2,
      "customersAffectedTotal": 1600,
      "customersAffectedTotalSupplied": true,
      "openCount": 1,
      "sources": [
        "Caller-supplied utility notice"
      ],
      "paidProviderUsed": false,
      "apiKeyRequired": false
    }
  ],
  "outages": [
    {
      "id": "O1",
      "region": "North",
      "startedAt": "2026-11-01T08:00:00.000Z",
      "endedAt": "2026-11-01T14:00:00.000Z",
      "customersAffected": 1200,
      "customersAffectedSupplied": true,
      "cause": "storm",
      "status": "restored",
      "source": "Caller-supplied utility notice"
    },
    {
      "id": "O2",
      "region": "North",
      "startedAt": "2026-11-03T09:00:00.000Z",
      "endedAt": "",
      "customersAffected": 400,
      "customersAffectedSupplied": true,
      "cause": "equipment",
      "status": "open",
      "source": "Caller-supplied utility notice"
    }
  ],
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/grid-outage-public-data-analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "outages": [
    {
      "id": "O1",
      "region": "North",
      "startedAt": "2026-11-01T08:00:00.000Z",
      "endedAt": "2026-11-01T14:00:00.000Z",
      "customersAffected": 1200,
      "cause": "storm",
      "status": "restored",
      "source": "Caller-supplied utility notice"
    },
    {
      "id": "O2",
      "region": "North",
      "startedAt": "2026-11-03T09:00:00.000Z",
      "customersAffected": 400,
      "cause": "equipment",
      "status": "open",
      "source": "Caller-supplied utility notice"
    }
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/electricity-market/exposure-report$0.08 USDC

Build electricity market exposure report

Aggregate price, demand, carbon, tariff, volatility, renewable, outage, and exposure findings from supplied records and optional key-free public datasets.

Body

Field	Required	Notes
`text`	No	string
`json`	No	string
`csv`	No	string
`file`	No	object; Object
`prices`	No	array; Array
`demand`	No	array; Array
`carbon`	No	array; Array
`tariffs`	No	array; Array
`bills`	No	array; Array
`generation`	No	array; Array
`outages`	No	array; Array
`exposures`	No	array; Array
`carbonIntensity`	No	object; Object
`worldBank`	No	object; Object
`feed`	No	object; Object
`asOf`	No	string

Request exampleJSON

{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 91,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    },
    {
      "id": "P4",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 88.4,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    }
  ],
  "demand": [
    {
      "id": "D1",
      "region": "GB",
      "at": "2026-11-01T18:00:00.000Z",
      "mw": 38500,
      "source": "Caller-supplied"
    },
    {
      "id": "D2",
      "region": "GB",
      "at": "2026-11-01T04:00:00.000Z",
      "mw": 27200,
      "source": "Caller-supplied"
    }
  ],
  "carbon": [
    {
      "id": "C1",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "intensity": 181,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    },
    {
      "id": "C2",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "intensity": 165,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    }
  ],
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "energyRate": 0.14,
      "fixedCharge": 120,
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "unit": "currency/kWh",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "kwh": 12000,
      "peakKw": 95,
      "billedEnergy": 1680,
      "billedDemand": 807.5,
      "billedFixed": 120,
      "billedTotal": 2607.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ],
  "generation": [
    {
      "id": "G1",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 8200,
      "isForecast": false,
      "source": "Caller-supplied"
    },
    {
      "id": "G2",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-05T12:00:00.000Z",
      "mw": 9100,
      "isForecast": true,
      "source": "Caller-supplied operator forecast"
    }
  ],
  "outages": [
    {
      "id": "O1",
      "region": "North",
      "startedAt": "2026-11-01T08:00:00.000Z",
      "endedAt": "2026-11-01T14:00:00.000Z",
      "customersAffected": 1200,
      "cause": "storm",
      "status": "restored",
      "source": "Caller-supplied utility notice"
    },
    {
      "id": "O2",
      "region": "North",
      "startedAt": "2026-11-03T09:00:00.000Z",
      "customersAffected": 400,
      "cause": "equipment",
      "status": "open",
      "source": "Caller-supplied utility notice"
    }
  ],
  "exposures": [
    {
      "id": "E1",
      "market": "N2EX",
      "volumeMwh": 5000,
      "hedgeRatio": 0.6,
      "source": "Caller-supplied"
    }
  ]
}

Response exampleJSON

{
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "status": "reported",
  "asOf": "2026-11-04T21:00:00.000Z",
  "sections": {
    "prices": {
      "pointCount": 4
    },
    "compare": {
      "marketCount": 2,
      "overallAverage": 85,
      "overallAverageSupplied": true
    },
    "demand": {
      "regionCount": 1
    },
    "carbon": {
      "pointCount": 2,
      "averageIntensity": 173,
      "averageIntensitySupplied": true
    },
    "bills": {
      "billCount": 1
    },
    "peak": {
      "itemCount": 2
    },
    "volatility": {
      "marketCount": 2
    },
    "renewable": {
      "historicalCount": 1,
      "forecastCount": 1,
      "forecastInvented": false
    },
    "outages": {
      "regionCount": 1,
      "outageCount": 2
    },
    "exposure": {
      "exposureCount": 1
    }
  },
  "forecastInvented": false,
  "billingAccuracyClaimed": false,
  "paidProviderUsed": false,
  "apiKeyRequired": false,
  "publicSources": [],
  "findings": [],
  "limitations": [
    "Prices, demand, carbon, tariffs, bills, generation, outages, and exposures are copied only from labeled fields supplied by the caller, or from key-free public Carbon Intensity / World Bank / feed responses when requested.",
    "No paid energy data provider is used and no API key is required.",
    "Missing prices, demand, carbon intensity, tariff rates, and forecast megawatts are not invented.",
    "Renewable generation forecasts are reported only from caller-supplied forecast rows or the public Carbon Intensity forecast endpoint when requested.",
    "Tariff and peak-demand calculations use only supplied rates and quantities; legal billing accuracy is not claimed."
  ]
}

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/electricity-market/exposure-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "asOf": "2026-11-04T21:00:00.000Z",
  "prices": [
    {
      "id": "P1",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 78.5,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P2",
      "market": "N2EX",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 82.1,
      "unit": "currency/MWh",
      "currency": "GBP",
      "source": "Caller-supplied"
    },
    {
      "id": "P3",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-01T12:00:00.000Z",
      "price": 91,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    },
    {
      "id": "P4",
      "market": "EPEX",
      "region": "DE",
      "at": "2026-11-02T12:00:00.000Z",
      "price": 88.4,
      "unit": "currency/MWh",
      "currency": "EUR",
      "source": "Caller-supplied"
    }
  ],
  "demand": [
    {
      "id": "D1",
      "region": "GB",
      "at": "2026-11-01T18:00:00.000Z",
      "mw": 38500,
      "source": "Caller-supplied"
    },
    {
      "id": "D2",
      "region": "GB",
      "at": "2026-11-01T04:00:00.000Z",
      "mw": 27200,
      "source": "Caller-supplied"
    }
  ],
  "carbon": [
    {
      "id": "C1",
      "region": "GB",
      "at": "2026-11-01T12:00:00.000Z",
      "intensity": 181,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    },
    {
      "id": "C2",
      "region": "GB",
      "at": "2026-11-02T12:00:00.000Z",
      "intensity": 165,
      "unit": "gCO2/kWh",
      "index": "moderate",
      "source": "Caller-supplied"
    }
  ],
  "tariffs": [
    {
      "id": "TF-1",
      "name": "Industrial TOU",
      "energyRate": 0.14,
      "fixedCharge": 120,
      "peakDemandRate": 8.5,
      "currency": "GBP",
      "unit": "currency/kWh",
      "demandUnit": "kW",
      "source": "Caller-supplied"
    }
  ],
  "bills": [
    {
      "id": "BL-1",
      "tariffId": "TF-1",
      "periodStart": "2026-10-01",
      "periodEnd": "2026-10-31",
      "kwh": 12000,
      "peakKw": 95,
      "billedEnergy": 1680,
      "billedDemand": 807.5,
      "billedFixed": 120,
      "billedTotal": 2607.5,
      "currency": "GBP",
      "source": "Caller-supplied"
    }
  ],
  "generation": [
    {
      "id": "G1",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-01T12:00:00.000Z",
      "mw": 8200,
      "isForecast": false,
      "source": "Caller-supplied"
    },
    {
      "id": "G2",
      "region": "GB",
      "fuel": "wind",
      "at": "2026-11-05T12:00:00.000Z",
      "mw": 9100,
      "isForecast": true,
      "source": "Caller-supplied operator forecast"
    }
  ],
  "outages": [
    {
      "id": "O1",
      "region": "North",
      "startedAt": "2026-11-01T08:00:00.000Z",
      "endedAt": "2026-11-01T14:00:00.000Z",
      "customersAffected": 1200,
      "cause": "storm",
      "status": "restored",
      "source": "Caller-supplied utility notice"
    },
    {
      "id": "O2",
      "region": "North",
      "startedAt": "2026-11-03T09:00:00.000Z",
      "customersAffected": 400,
      "cause": "equipment",
      "status": "open",
      "source": "Caller-supplied utility notice"
    }
  ],
  "exposures": [
    {
      "id": "E1",
      "market": "N2EX",
      "volumeMwh": 5000,
      "hedgeRatio": 0.6,
      "source": "Caller-supplied"
    }
  ]
}
JSON