fourzerotwo-si Gb Electricity API

GB Electricity Grid: Live and forecast Great Britain electricity data: generation mix, demand, wind, prices, interconnectors, margins, frequency and plant outages.

Operations 26

GET /v1/gb-electricity/generation-now GB Electricity Grid: Generation mix now #
GET /v1/gb-electricity/generation-today GB Electricity Grid: Generation by type, 24h #
GET /v1/gb-electricity/generation-history GB Electricity Grid: Generation mix history #
GET /v1/gb-electricity/interconnectors GB Electricity Grid: Interconnector flows #
GET /v1/gb-electricity/interconnector-list GB Electricity Grid: Interconnectors #
GET /v1/gb-electricity/demand-outturn GB Electricity Grid: Demand outturn #
GET /v1/gb-electricity/demand-daily GB Electricity Grid: Daily demand #
GET /v1/gb-electricity/demand-peak GB Electricity Grid: Peak demand #
GET /v1/gb-electricity/demand-forecast GB Electricity Grid: Demand forecast, day ahead #
GET /v1/gb-electricity/demand-forecast-14d GB Electricity Grid: Demand forecast, 14 days #
GET /v1/gb-electricity/demand-forecast-52w GB Electricity Grid: Demand forecast, 52 weeks #
GET /v1/gb-electricity/wind-forecast GB Electricity Grid: Wind forecast #
GET /v1/gb-electricity/wind-forecast-peak GB Electricity Grid: Wind forecast daily peak #
GET /v1/gb-electricity/indicated-forecast GB Electricity Grid: Indicated demand & generation #
GET /v1/gb-electricity/capacity-forecast GB Electricity Grid: Generation capacity, 14 days #
GET /v1/gb-electricity/margin-forecast GB Electricity Grid: Margin forecast #
GET /v1/gb-electricity/surplus-forecast GB Electricity Grid: Surplus forecast #
GET /v1/gb-electricity/system-prices GB Electricity Grid: Imbalance (system) prices #
GET /v1/gb-electricity/acceptances-latest GB Electricity Grid: Latest balancing acceptances #
GET /v1/gb-electricity/frequency GB Electricity Grid: System frequency #
GET /v1/gb-electricity/temperature GB Electricity Grid: GB temperature #
GET /v1/gb-electricity/warnings GB Electricity Grid: System warnings #
GET /v1/gb-electricity/outages GB Electricity Grid: REMIT outage notices #
GET /v1/gb-electricity/outage GB Electricity Grid: REMIT outage detail #
GET /v1/gb-electricity/wind-solar GB Electricity Grid: Wind & solar outturn #
GET /v1/gb-electricity/market-index GB Electricity Grid: Wholesale market index price #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/fourzerotwo-si:fourzerotwo-si-gb-electricity-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

fourzerotwo-si-gb-electricity-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Fourzerotwo Si Gb Electricity API
  version: 1.1.0
  contact:
    url: https://fourzerotwo.si
  description: 'Operations tagged gb-electricity across 2 of this provider''s published API definitions: openapi.json, fourzerotwo-si-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://fourzerotwo.si
tags:
- name: gb-electricity
  description: 'GB Electricity Grid: Live and forecast Great Britain electricity data: generation mix, demand, wind, prices, interconnectors, margins, frequency and plant outages.'
paths:
  /v1/gb-electricity/generation-now:
    get:
      operationId: gb_electricity__generation_now
      summary: 'GB Electricity Grid: Generation mix now'
      description: 'Current GB generation by fuel type (MW and %), latest 5-minute reading and last half hour / 24 hours. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/generation-now
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__generation-now
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/generation-today:
    get:
      operationId: gb_electricity__generation_today
      summary: 'GB Electricity Grid: Generation by type, 24h'
      description: 'Actual generation by production type over the last 24 hours (solar, wind, nuclear, gas…). Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/generation-today
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__generation-today
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/generation-history:
    get:
      operationId: gb_electricity__generation_history
      summary: 'GB Electricity Grid: Generation mix history'
      description: 'Half-hourly generation by fuel type, recent history. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/generation-history
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__generation-history
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/interconnectors:
    get:
      operationId: gb_electricity__interconnectors
      summary: 'GB Electricity Grid: Interconnector flows'
      description: 'Latest half-hourly flows on each interconnector (France, Norway, Netherlands, Belgium, Ireland, Denmark…), newest first. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/interconnectors
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__interconnectors
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/interconnector-list:
    get:
      operationId: gb_electricity__interconnector_list
      summary: 'GB Electricity Grid: Interconnectors'
      description: 'Every GB interconnector and the bidding zone it connects to. Price: $0.0005 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/interconnector-list
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.000500'
      x-free-tier: free
      x-mcp-tool: gb-electricity__interconnector-list
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-outturn:
    get:
      operationId: gb_electricity__demand_outturn
      summary: 'GB Electricity Grid: Demand outturn'
      description: 'Initial national and transmission demand, half-hourly, last ~2 days. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-outturn
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-outturn
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-daily:
    get:
      operationId: gb_electricity__demand_daily
      summary: 'GB Electricity Grid: Daily demand'
      description: 'Total national demand per day, recent days. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-daily
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-daily
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-peak:
    get:
      operationId: gb_electricity__demand_peak
      summary: 'GB Electricity Grid: Peak demand'
      description: 'Daily peak transmission demand. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-peak
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-peak
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-forecast:
    get:
      operationId: gb_electricity__demand_forecast
      summary: 'GB Electricity Grid: Demand forecast, day ahead'
      description: 'Half-hourly national and transmission demand forecast for the next day. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-forecast-14d:
    get:
      operationId: gb_electricity__demand_forecast_14d
      summary: 'GB Electricity Grid: Demand forecast, 14 days'
      description: 'Daily peak demand forecast for the next two weeks. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-forecast-14d
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-forecast-14d
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/demand-forecast-52w:
    get:
      operationId: gb_electricity__demand_forecast_52w
      summary: 'GB Electricity Grid: Demand forecast, 52 weeks'
      description: 'Weekly peak demand forecast for the year ahead. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/demand-forecast-52w
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__demand-forecast-52w
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/wind-forecast:
    get:
      operationId: gb_electricity__wind_forecast
      summary: 'GB Electricity Grid: Wind forecast'
      description: 'Current wind generation forecast, half-hourly, for the next ~2 days. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/wind-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__wind-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/wind-forecast-peak:
    get:
      operationId: gb_electricity__wind_forecast_peak
      summary: 'GB Electricity Grid: Wind forecast daily peak'
      description: 'Forecast peak wind generation for each day. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/wind-forecast-peak
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__wind-forecast-peak
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/indicated-forecast:
    get:
      operationId: gb_electricity__indicated_forecast
      summary: 'GB Electricity Grid: Indicated demand & generation'
      description: 'Day-ahead indicated demand, generation, imbalance and margin. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/indicated-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__indicated-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/capacity-forecast:
    get:
      operationId: gb_electricity__capacity_forecast
      summary: 'GB Electricity Grid: Generation capacity, 14 days'
      description: 'Forecast available generation capacity by fuel type for the next two weeks. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/capacity-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__capacity-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/margin-forecast:
    get:
      operationId: gb_electricity__margin_forecast
      summary: 'GB Electricity Grid: Margin forecast'
      description: 'Daily operating margin forecast (OCNMFD2), days 2–14. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/margin-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__margin-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/surplus-forecast:
    get:
      operationId: gb_electricity__surplus_forecast
      summary: 'GB Electricity Grid: Surplus forecast'
      description: 'Daily generating plant surplus forecast, days 2–14. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/surplus-forecast
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__surplus-forecast
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/system-prices:
    get:
      operationId: gb_electricity__system_prices
      summary: 'GB Electricity Grid: Imbalance (system) prices'
      description: 'System sell/buy price and net imbalance volume for every settlement period of a day. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/system-prices
      parameters:
      - name: date
        in: query
        required: true
        description: Settlement date YYYY-MM-DD
        schema:
          type: string
          maxLength: 20
        example: '2026-10-10'
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__system-prices
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/acceptances-latest:
    get:
      operationId: gb_electricity__acceptances_latest
      summary: 'GB Electricity Grid: Latest balancing acceptances'
      description: 'Most recent bid-offer acceptances issued by the system operator. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/acceptances-latest
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__acceptances-latest
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/frequency:
    get:
      operationId: gb_electricity__frequency
      summary: 'GB Electricity Grid: System frequency'
      description: 'Grid frequency (Hz) every 15 seconds, last hour. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/frequency
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__frequency
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/temperature:
    get:
      operationId: gb_electricity__temperature
      summary: 'GB Electricity Grid: GB temperature'
      description: 'Daily GB average temperature against seasonal reference values (drives demand). Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/temperature
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__temperature
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/warnings:
    get:
      operationId: gb_electricity__warnings
      summary: 'GB Electricity Grid: System warnings'
      description: 'System operator warnings and notices (margin notices, SO-SO trades, electricity capacity warnings). Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/warnings
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__warnings
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/outages:
    get:
      operationId: gb_electricity__outages
      summary: 'GB Electricity Grid: REMIT outage notices'
      description: 'Outage and unavailability messages published between two times (ids; fetch each with outage). Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/outages
      parameters:
      - name: from
        in: query
        required: true
        description: From (ISO time, e.g. 2026-10-10T00:00Z)
        schema:
          type: string
          maxLength: 25
        example: 2026-10-10T00:00Z
      - name: to
        in: query
        required: true
        description: To (ISO time)
        schema:
          type: string
          maxLength: 25
        example: 2026-10-10T06:00Z
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__outages
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/outage:
    get:
      operationId: gb_electricity__outage
      summary: 'GB Electricity Grid: REMIT outage detail'
      description: 'One outage notice: plant, fuel, normal/available capacity, cause and event window. Price: $0.001 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/outage
      parameters:
      - name: id
        in: query
        required: true
        description: Message id from outages
        schema:
          type: integer
        example: 923953
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.001000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__outage
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/wind-solar:
    get:
      operationId: gb_electricity__wind_solar
      summary: 'GB Electricity Grid: Wind & solar outturn'
      description: 'Actual or estimated wind (on/offshore) and solar generation between two dates. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/wind-solar
      parameters:
      - name: from
        in: query
        required: true
        description: Start date YYYY-MM-DD
        schema:
          type: string
          maxLength: 20
        example: '2026-10-09'
      - name: to
        in: query
        required: true
        description: End date YYYY-MM-DD
        schema:
          type: string
          maxLength: 20
        example: '2026-10-10'
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__wind-solar
    servers:
    - url: https://fourzerotwo.si
  /v1/gb-electricity/market-index:
    get:
      operationId: gb_electricity__market_index
      summary: 'GB Electricity Grid: Wholesale market index price'
      description: 'Market Index Data: half-hourly wholesale price (£/MWh) and volume between two dates. Price: $0.002 USDC per call via x402. Free within the daily allowance with a free key.'
      tags:
      - gb-electricity
      externalDocs:
        url: https://fourzerotwo.si/apis/gb-electricity/market-index
      parameters:
      - name: from
        in: query
        required: true
        description: Start date YYYY-MM-DD
        schema:
          type: string
          maxLength: 20
        example: '2026-10-09'
      - name: to
        in: query
        required: true
        description: End date YYYY-MM-DD
        schema:
          type: string
          maxLength: 20
        example: '2026-10-10'
      responses:
        '200':
          description: The data (paid, or free tier).
          content:
            application/json: {}
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
      security:
      - {}
      - freeKey: []
      x-price-usd: '0.002000'
      x-free-tier: free
      x-mcp-tool: gb-electricity__market-index
    servers:
    - url: https://fourzerotwo.si
components:
  responses:
    PaymentRequired:
      description: x402 payment required. The body (also base64 in the PAYMENT-REQUIRED header) lists accepted payments.
      headers:
        PAYMENT-REQUIRED:
          schema:
            type: string
          description: Base64 JSON x402 v2 PaymentRequired
      content:
        application/json:
          schema:
            type: object
            properties:
              x402Version:
                type: integer
              error:
                type: string
              accepts:
                type: array
                items:
                  type: object
    Error:
      description: 400 = invalid input, 404 = not found at the source, 502 = the source failed. Never charged.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              charged:
                type: boolean
  securitySchemes:
    freeKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Optional free key (fzt_…) for the free tier.
x-refined-from:
- openapi.json
- fourzerotwo-si-openapi.json