2025-11-24 | Added GB forecasts endpoint and updated forecast schemas

Added

GB forecasts list endpoint

GET /forecasts/gb-forecasts-list/

New endpoint for retrieving Great Britain forecast data.

Solar configuration fields

Forecast run assets now support custom solar profiles and location-based configuration.

New fields:

  • custom_solar_profile (object) - Custom solar generation profile
  • custom_solar_profile_id (uuid) - Reference to custom solar profile
  • latitude (number) - Asset latitude coordinate
  • longitude (number) - Asset longitude coordinate
  • azimuth (number) - Solar panel azimuth angle
  • tilt (number) - Solar panel tilt angle
  • market_region (string) - Market region identifier

GB-specific field:

  • cfd_strike_price (number) - Contract for Difference strike price (0-200)

Changed

Forecast asset validation constraints

Asset configuration limits updated across forecast endpoints.

POST /forecasts/run-simulation/ and GET /forecasts/forecasts/:

  • max_cycles minimum reduced from 1.0 to 0.5
  • duration maximum reduced from 10 to 8
  • repowering validation constraints removed

ERCOT forecast revenue fields

Multiple revenue breakdown fields removed from ERCOT forecast responses.

GET /forecasts/ercot-forecasts-list/:

Removed fields:

  • ancillary_services_revenue
  • ancillary_services_revenue_per_mw
  • avg_real_time_energy_price
  • real_time_energy_revenue
  • real_time_energy_revenue_per_mw
  • total_revenue_per_mw

Type changes:

  • avg_ancillary_services_price changed from number to string
  • avg_cycles_per_day changed from number to string
  • total_revenues changed from number to string

Applies to both annual_energy_only_focus_data, annual_energy_with_as_focus_data, monthly_energy_only_focus_data, and monthly_energy_with_as_focus_data arrays.

GB forecast revenue field types

Revenue and metric fields changed from number to string format.

GET /forecasts/forecasts/{id}/:

Type changes in annual/monthly ancillaries and merchant focus data:

  • avg_cycles_per_day
  • avg_wholesale_day_ahead_price
  • balancing_mechanism_revenues
  • balancing_reserve_revenues
  • capacity_market_revenues
  • duos_* fields (all DUOS-related revenues)
  • frequency_response_revenues
  • tnuos_revenues
  • total_revenues
  • total_revenues_battery_excl_duos
  • total_revenues_solar_excl_duos
  • wholesale_day_ahead_battery_revenues
  • wholesale_day_ahead_solar_revenues
  • wholesale_day_ahead_total_revenues
  • wholesale_intraday_revenues
  • capacity_mwh_battery in forecast metadata

Documentation removed: Contextual descriptions removed from co-located and non-co-located revenue fields. Fields remain functionally unchanged.


Documentation updates

400 Bad Request response removed from /forecasts/macro-scenarios/ endpoint documentation. Nullability markers and integer validation constraints cleaned up across forecast schemas.