# Prod public API Documentation ## Guides - [EPEX Auction Data](https://developers.modoenergy.com/docs/epex-auction-data.md) - [EPEX Intraday Continuous Market](https://developers.modoenergy.com/docs/epex-intraday-continuous-market.md): All the data you need to understand the EPEX Continuous Intraday market, all in one place - [EPEX Live Continuous Data Information](https://developers.modoenergy.com/docs/epex.md): Usage documentation - [Modo Monthly Leaderboard GB](https://developers.modoenergy.com/docs/modo-monthly-leaderboard-gb.md): A guide to using our monthly leaderboard dataset, especially for those using Data Downloads. - [Live Balancing Mechanism calculations](https://developers.modoenergy.com/docs/modo-realtime-system-imbalance-calculations.md): Get NIV and system price, realtime, for free. No more waiting for Elexon to publish them 1 hour after the event! - [Wholesale Power Prices](https://developers.modoenergy.com/docs/wholesale-power-prices.md): We've got ALL of the Day ahead and intraday auction clearing prices for GB and Europe - [Authorisation](https://developers.modoenergy.com/docs/authorization.md): How does our API authorisation works - [Getting started with Python](https://developers.modoenergy.com/docs/getting-started-with-python.md) - [Getting Started with the Modo Energy API](https://developers.modoenergy.com/docs/getting-started.md) - [Making your first call](https://developers.modoenergy.com/docs/making-your-first-call.md): Zero to 200 in record time - [Using the API with MS Excel](https://developers.modoenergy.com/docs/using-the-api-with-ms-excel-copy.md): Getting started from scratch - [What is an API and why should I use it?](https://developers.modoenergy.com/docs/what-is-an-api.md): Getting started with the API from scratch - [Error codes](https://developers.modoenergy.com/docs/errors.md): Common error codes in API usage ## API Reference - [Asset Operations](https://developers.modoenergy.com/reference/asset-operations.md): Live detailed revenue breakdown for individual GB battery assets. - [AUS NEM Asset Revenue Timeseries](https://developers.modoenergy.com/reference/aus-nem-asset-revenue-timeseries.md): Retrieves time-series revenue data for a specific asset in the Australian NEM over a defined time range. - [AUS NEM Asset Revenue](https://developers.modoenergy.com/reference/aus-nem-asset-revenue.md): Retrieves revenue data for a specific asset within the Australian National Electricity Market (NEM) over a defined time range. - [BESS Physical Operations and Availability](https://developers.modoenergy.com/reference/bess-physical-operations-and-availability.md): Availability and physical operations breakdown for individual battery assets in ERCOT. 60-day delayed data. - [Index Breakdown](https://developers.modoenergy.com/reference/index-breakdown.md): Live Leaderboard data for individual GB battery assets. - [ME BESS AUS NEM Breakdown](https://developers.modoenergy.com/reference/me-bess-aus-nem-breakdown.md): Retrieves revenue data for each battery energy storage system (BESS) asset in the Australian NEM, broken down by revenue stream. - [ME BESS ERCOT Breakdown](https://developers.modoenergy.com/reference/me-bess-ercot-breakdown.md): Revenues earned by each ERCOT battery energy storage asset broken down by individual revenue streams. 60-day delayed data. - [Modo Energy Asset Database - ERCOT](https://developers.modoenergy.com/reference/modo-energy-asset-database-ercot.md): This database contains every ERCOT BESS asset that Modo Energy tracks. - [Modo Energy Asset Database - GB](https://developers.modoenergy.com/reference/modo-energy-asset-database-gb.md): A database of every GB BESS asset that Modo Energy tracks. - [Modo Energy Asset Database - NEM](https://developers.modoenergy.com/reference/modo-energy-asset-database-nem.md): This database contains every NEM BESS asset that Modo Energy tracks. - [Modo Energy BESS Asset Database - Australia (NEM)](https://developers.modoenergy.com/reference/modo-energy-bess-asset-database-australia-nem.md): Lists all battery energy storage system (BESS) assets currently operating in the Australian NEM, along with key details such as rated power, energy capacity, settlement point location, and ownership. - [Monthly Leaderboard](https://developers.modoenergy.com/reference/monthly-leaderboard.md): GB Leaderboard results per calendar month - [AS DAM Clearing Prices](https://developers.modoenergy.com/reference/as-dam-clearing-prices.md): The ancillary services prices cleared in different CAISO regions through the Day-Ahead Market. - [AS FMM Clearing Prices](https://developers.modoenergy.com/reference/as-fmm-clearing-prices.md): The ancillary services prices cleared in different CAISO regions through the Fifteen Minute Market (FMM). - [Energy Storage Report](https://developers.modoenergy.com/reference/energy-storage-report.md): Information about grid-scale batteries in the CAISO markets, including the total volumes of battery energy dispatched in each market, total state of charge of the batteries in each market, and ancillary service awards for both solo and hybrid batteries. - [FMM/RTPD Locational Marginal Price - RTM](https://developers.modoenergy.com/reference/fmmrtpd-locational-marginal-price-rtm.md): Locational Marginal Prices in the Real-Time Market for the Real-Time Pre-Dispatch (Fifteen Minute Market, FMM). - [Generation by fuel type](https://developers.modoenergy.com/reference/generation-by-fuel-type-caiso.md): Generation by fuel type in the CAISO region - [Locational Marginal Price - DAM](https://developers.modoenergy.com/reference/locational-marginal-price-dam.md): Locational Marginal Prices for each Node in the Day-Ahead Integrated Forward Market for Energy. - [RTD Locational Marginal Price - RTM](https://developers.modoenergy.com/reference/rtd-locational-marginal-price-rtm.md): Locational Marginal Prices in the Real-Time Market for Real-Time Dispatch (5 minute market). - [RUC Locational Marginal Price - DAM](https://developers.modoenergy.com/reference/ruc-locational-marginal-price-dam.md): Locational Marginal Prices for each Node in the Day-Ahead Integrated Forward Market for Residual Unit Commitment. - [Wind and Solar Generation - Forecasted and Actual](https://developers.modoenergy.com/reference/wind-and-solar-generation-forecasted-and-actual.md): Forecasted and actual generation values for Wind and Solar resources in the CAISO region, with regional breakdown. - [BESS Owners - ERCOT](https://developers.modoenergy.com/reference/bess-owners-ercot.md): The power and energy capacity of the ERCOT BESS assets owned by each Owner on a monthly basis. Updated on the first of the month every month. - [BESS Owners - GB](https://developers.modoenergy.com/reference/bess-owners-gb.md): The power and energy capacity of the GB BESS assets owned by each Owner on a monthly basis. Updated on the first of the month every month. - [2 to 14 Days Ahead Generation availability aggregated by Balancing Mechanism Units](https://developers.modoenergy.com/reference/2-to-14-days-ahead-generation-availability-aggregated-by-balancing-mechanism-units.md): This endpoint provides a forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 days ahead to 14 days ahead; it is aggregated by National Grid Balancing Mechanism Units (NGC BMUs). In the context of this report, BMUs can be considered as generating units. Elexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'. The mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints. - [2 to 14 Days Ahead Generation availability aggregated by Fuel Type (FOU2T14D)](https://developers.modoenergy.com/reference/2-to-14-days-ahead-generation-availability-aggregated-by-fuel-type-fou2t14d.md): This endpoint provides a forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering 2 days ahead to 14 days ahead; it is aggregated by Fuel Types categories. - [2 to 14 Days Ahead Generation availability aggregated data](https://developers.modoenergy.com/reference/2-to-14-days-ahead-generation-availability-aggregated-data.md): This endpoint provides a forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering 2 days ahead to 14 days ahead. The data is aggregated at national level. - [2 to 156 Weeks Ahead Generation availability aggregated by Balancing Mechanism Units](https://developers.modoenergy.com/reference/2-to-156-weeks-ahead-generation-availability-aggregated-by-balancing-mechanism-units.md): This endpoint forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by Balancing Mechanism Units (BMUs). In the context of this report, BMUs can be considered as generating units. Elexon BMUs differs from NGC BMUs by including a prefix e.g. 'T_'. The mapping between NGC and Elexon BMUs can be retrieved via reference data API endpoints. - [2 to 156 Weeks Ahead Generation availability aggregated by Fuel Type](https://developers.modoenergy.com/reference/2-to-156-weeks-ahead-generation-availability-aggregated-by-fuel-type.md): This endpoint provides a forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 weeks ahead to 156 weeks ahead; it is aggregated by Fuel Types categories. - [2 to 156 Weeks Ahead Generation availability aggregated data](https://developers.modoenergy.com/reference/2-to-156-weeks-ahead-generation-availability-aggregated-data.md): This endpoint provides a forward view of availability (also referred to as Output Usable data under the Grid Code) for generation and interconnector capacity, accounting for planned outages covering availability data from 2 weeks ahead to 156 weeks ahead. The data is an aggregation of all Fuel Type categories at national level. - [Balancing Services Volume](https://developers.modoenergy.com/reference/balancing-services-volume.md): This endpoint provides Balancing Services Volume data received from NGESO. Balancing Services Volume is a volume which is received from the System Operator, which represents the volume of energy (MWh) associated with the provision of Applicable Balancing Services for each relevant BM Unit and Settlement Period. QAS can be positive or negative and is normally only provided where there is a non-zero volume. - [Bid Offer Acceptance Level Flagged](https://developers.modoenergy.com/reference/bid-offer-acceptance-level-flagged.md): This endpoint provides bid offer acceptance data. - [Bid Offer Data](https://developers.modoenergy.com/reference/bid-offer-data.md): This endpoint provides bid-offer data - [BMU IDs and Fuel Types](https://developers.modoenergy.com/reference/bmu-ids-and-fuel-types.md): A current list of BM units from Elexon Insights. - [Day and Day-Ahead Indicated Demand](https://developers.modoenergy.com/reference/day-and-day-ahead-indicated-demand.md): This endpoint provides the indicated demand forecast for the current day and day-ahead received from NGESO. The forecast is updated every half hour. The forecast for each period is the sum of all the PNs submitted for BM Units which are forecast to be importing energy. Data is presented an average MW for the Settlement Period. - [Day and Day-Ahead Indicated Generation](https://developers.modoenergy.com/reference/day-and-day-ahead-indicated-generation.md): This endpoint provides the Indicated Generation received from NGESO. Data is received daily, by midday. Expressed as an average MW value for each Settlement period. The Indicated Generation forecast for each period is the sum of all the PNs submitted for BM Units which are forecast to be exporting energy, presented as a single average MW value for the Settlement Period. - [Day and Day-Ahead Indicated Imbalance](https://developers.modoenergy.com/reference/day-and-day-ahead-indicated-imbalance.md): This endpoint provides the Indicated Imbalance. Data is received by daily by midday from NGESO. Expressed as an average MW value for each Settlement period. The Indicated Imbalance forecast for each period is the difference between the sum of the PNs submitted for generation BM Units (i.e. the Indicated Generation,and the National Demand Forecast made by the System Operator. - [Day and Day-Ahead Indicated Margin](https://developers.modoenergy.com/reference/day-and-day-ahead-indicated-margin.md): This endpoint provides the Indicated Margin. Data is received every half an hour from NGESO. Expressed as an average MW value for each Settlement period. The Indicated Margin forecast for each Settlement Period is the difference between the sum of the MELs submitted for that period, and the National Demand Forecast made by the System Operator. The greater the value, the higher the margin between available generation capacity and forecast demand - that is to say, the more spare capacity there is forecast to be in the system. - [Day and Day-Ahead Transmission System Demand Forecast](https://developers.modoenergy.com/reference/day-and-day-ahead-transmission-system-demand-forecast.md): This endpoint provides the Transmission System forecast. Data is received from 9am on current day from NGESO and will show values for the day ahead. Expressed as an average MW value for each Settlement period. The Transmission System Demand Forecast is based on historically metered generation output for Great Britain. This value INCLUDES Interconnector flows and demand from station transformers and pumped storage units. - [Demand and Surplus Forecast Data (2-14 days ahead) Generating Plant Demand Margin](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-14-days-ahead-generating-plant-demand-margin.md): The Demand and Surplus forecast demand margin data is received hourly from NGESO. It shows the daily peak half hour MW value of Generating Plant Demand Surplus for each day for the 2 to 14 days ahead. - [Demand and Surplus Forecast Data (2-14 days ahead) National Demand](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-14-days-ahead-national-demand.md): This endpoint provides the National Demand forecast received from NGESO. Data is available from 9am on current day and will show values for the 2 to 14 days ahead. Expressed as an average MW value for each Settlement period. The forecast is based on historically metered generation output for Great Britain. This value INCLUDES transmission losses, but EXCLUDES Interconnector flows and demand from station. - [Demand and Surplus Forecast Data (2-14 days ahead) Surplus](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-14-days-ahead-surplus.md): The Demand and Surplus forecast demand margin data is received hourly from NGESO. It shows the daily peak half hour MW value of Generating Plant Demand Surplus for each day for the 2 to 14 days ahead. - [Demand and Surplus Forecast Data (2-14 days ahead) Transmission System](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-14-days-ahead-transmission-system.md): This end point provides the Transmission System forecast. Data is available from 9am on current day and will show values for the 2 to 14 days ahead. Expressed as an average MW value for each Settlement period. The Transmission System Demand Forecast is based on historically metered generation output for Great Britain. This value INCLUDES Interconnector flows and demand from station transformers and pumped storage units. Specific publish time filters may be supplied, otherwise this will retrieve the latest published forecast. - [Demand and Surplus Forecast Data (2-156 weeks ahead) Generating Plant Demand Margin](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-156-weeks-ahead-generating-plant-demand-margin.md): The Demand and Surplus forecast surplus data is received hourly from NGESO. It shows the daily peak half hour MW value of Generating Plant Demand Margin for each week for the 2 to 156 weeks ahead. - [Demand and Surplus Forecast Data (2-156 weeks ahead) Surplus](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-156-weeks-ahead-surplus.md): The Demand and Surplus forecast surplus data is received hourly from NGESO. It shows the daily peak half hour MW value of Generating Plant Demand Margin for each week for the 2 to 156 weeks ahead. - [Demand and Surplus Forecast Data (2-52 weeks ahead) National Demand](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-52-weeks-ahead-national-demand.md): This endpoint provides the National Demand forecast received from NGESO. Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead. Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain. This value INCLUDES transmission losses, but EXCLUDES Interconnector flows and demand from station. - [Demand and Surplus Forecast Data (2-52 weeks ahead) Transmission System Demand](https://developers.modoenergy.com/reference/demand-and-surplus-forecast-data-2-52-weeks-ahead-transmission-system-demand.md): This endpoint provides the Transmission System Demand forecast received from NGESO. Data is available from 4pm each Thursday and will show values for the 2 to 52 weeks ahead. Expressed as an average MW value for each week. The forecast is based on historically metered generation output for Great Britain. This value INCLUDES transmission losses, but EXCLUDES Interconnector flows and demand from station. This API will provide a maximum data output range of 366 days. - [Detailed BMU database](https://developers.modoenergy.com/reference/detailed-bmu-database.md): This dataset contains a list of BMUs which includes locational details and thorough fuel type sorting.The valid_from field begins in April 2024, as that is when this dataset started to be compiled. All new BMUs are automatically added to this list. - [Detailed System Price (ISPSTACK)](https://developers.modoenergy.com/reference/detailed-system-price-ispstack.md): Bid-offer stacks by settlement period, with detailed system prices generated by the most recent run of calculations by Elexon. Data received from Elexon Insights. - [Disaggregated balancing services adjustment per settlement period](https://developers.modoenergy.com/reference/disaggregated-balancing-services-adjustment-per-settlement-period.md): This endpoint provides disaggregated balancing services adjustment data for a single settlement period. The response includes all the buying and selling actions that occurred during that settlement period. - [Half-hourly generation outturn by fuel type](https://developers.modoenergy.com/reference/half-hourly-generation-outturn-by-fuel-type.md): This endpoint provides the half-hourly generation outturn (Generation By Fuel type) to give our users an indication of the generation outturn for Great Britain. The data is aggregated by Fuel Type category and updated at 30-minute intervals with average MW values over 30 minutes for each category. - [Initial Demand Outturn data](https://developers.modoenergy.com/reference/initial-demand-outturn-data.md): The endpoint provides data showing the Initial Demand outturn. - [Initial Transmission System Outturn data](https://developers.modoenergy.com/reference/initial-transmission-system-outturn-data.md): The endpoint provides data showing the Transmission System Initial Demand outturn. - [Instantaneous generation outturn by fuel type](https://developers.modoenergy.com/reference/instantaneous-generation-outturn-by-fuel-type.md): This endpoint provides the instantaneous generation outturn (Generation By Fuel type) to give our users an indication of the generation outturn for Great Britain. The data is aggregated by Fuel Type category. - [Loss of Load Probability and De-rated Margin (LOLPDRM)](https://developers.modoenergy.com/reference/loss-of-load-probability-and-de-rated-margin-lolpdrm.md): Loss of load probability and de-rated margin calculated by NGESO, received from Elexon Insights. - [Market Index Data](https://developers.modoenergy.com/reference/market-index-data.md): This endpoint provides Market Index Data received from NGESO. Market Index Data is a key component in the calculation of System Buy Price and System Sell Price for each Settlement Period. This data is received from each of the appointed Market Index Data Providers (MIDPs) and reflects the price of wholesale electricity in Great Britain in the short term markets. The Market Index Data which is received from each MIDP for each Settlement Period consists of a Market Index Volume and Market Index Price, representing the volume and price of trading for the relevant period in the market operated by the MIDP. The Market Price (the volume weighed average Market Index Price) is used to derive the Reverse Price (SBP or SSP). - [Maximum Delivery Period](https://developers.modoenergy.com/reference/maximum-delivery-period.md): Maximum Delivery Period (MDP) is the maximum period, expressed in minutes, over which the Maximum Delivery Volume (MDV) applies. Maximum Delivery Volume is the maximum number of MWh of Offer (or Bid) that a particular BM Unit may deliver within the associated Maximum Delivery Period. - [Maximum Delivery Volume](https://developers.modoenergy.com/reference/maximum-delivery-volume.md): This endpoint provides Maximum Delivery Volume data received from NGESO. Maximum Delivery Volume is the maximum number of MWh of Offer (or Bid,that a particular BM Unit may deliver within the associated Maximum Delivery Period. - [Maximum Export Limit](https://developers.modoenergy.com/reference/maximum-export-limit.md): This endpoint provides Maximum Export Limit data received from NGESO. - [Maximum Import Limit](https://developers.modoenergy.com/reference/maximum-import-limit.md): This endpoint provides Maximum Import Limit data received from NGESO. - [Minimum Non-Zero Time](https://developers.modoenergy.com/reference/minimum-non-zero-time.md): This endpoint provides Minimum Non Zero Time data received from NGESO. The Minimum Non-Zero Time represents the minimum time that a BM Unit can operate at a non-zero level as a result of a Bid-Offer Acceptance. - [Minimum Zero Time](https://developers.modoenergy.com/reference/minimum-zero-time.md): This endpoint provides Minimum Zero Time data received from NGESO. The Minimum Zero Time is the minimum time that a BM Unit which has been exporting must operate at zero or import, before returning to export; whereas if the BM Unit has been importing, the MZT indicates the minimum time that it must operate at zero or export before returning to import, if action by the System Operator (i.e. a Bid-Offer Acceptance) places it at such a level. - [National Day and Day-Ahead National Demand Forecast](https://developers.modoenergy.com/reference/national-day-and-day-ahead-national-demand-forecast.md): This endpoint provides the National Demand forecast received from NGESO. Data is available from 9am on current day and will show values for the day ahead. Expressed as an average MW value for each Settlement period. The forecast is based on historically metered generation output for Great Britain. This value INCLUDES transmission losses, but EXCLUDES Interconnector flows and demand from station transformers and pumped storage units. - [Net Balancing Services Adjustment Data](https://developers.modoenergy.com/reference/net-balancing-services-adjustment-data.md): This endpoint provides Net Balancing Services Adjustment data received from NGESO. Net Balancing Services Adjustment data covers the buy/sell price, cost and volume adjustments for each settlement period. - [Non-BM STOR](https://developers.modoenergy.com/reference/non-bm-stor.md): This endpoint provides data about the Short Term Operating Reserves (STOR) that have been made use of by NGESO. This is activity that is outside of the Balancing Mechanism and takes place to meet the need to increase generation or decrease demand. - [Notice to Deliver Bids](https://developers.modoenergy.com/reference/notice-to-deliver-bids.md): This endpoint provides Notice to Deliver Bids data received from NGESO. Notice to Deliver Bids (NTB) indicates the length of time between the issuing of a Bid-Offer Acceptance and the time when a BM Unit begins to deliver Bid volumes, expressed in minutes. - [Notice to Deliver Offers](https://developers.modoenergy.com/reference/notice-to-deliver-offers.md): This endpoint provides Notice to Deliver Offers data received from NGESO. Notice to Deliver Offers (NTO) indicates the length of time required for a BM Unit to start delivering Offers from the time that the Bid-Offer Acceptance is issued, expressed in minutes. - [Notice to Deviate from Zero](https://developers.modoenergy.com/reference/notice-to-deviate-from-zero.md): This endpoint provides Notice to Deviate from Zero data received from NGESO. Notice to Deviate from Zero (NDZ) indicates the length of time required for a BM Unit to start importing or exporting energy, from a zero Physical Notification level as a result of a Bid-Offer Acceptance, expressed in minutes. - [Output per Generation Unit (B1610)](https://developers.modoenergy.com/reference/output-per-generation-unit-b1610.md): Actual metered volume output in MWh for all BM units, per settlement period. Published 5 days after delivery period. - [Physical Notifications](https://developers.modoenergy.com/reference/physical-notifications.md): This endpoint provides Physical Notification data received from NGESO. It returns the data valid for a single settlement period. A Physical Notification is the best estimate of the level of generation or demand that a participant in the BM expects a BM Unit to export or import, respectively, in a Settlement Period. - [Quiescent Physical Notifications](https://developers.modoenergy.com/reference/quiescent-physical-notifications.md): This endpoint provides Quiescent Physical Notification data received from NGESO. It returns the data valid for a single settlement period. Quiescent Physical Notifications describe the MW levels to be deducted from the Physical Notification of a BM Unit to determine a resultant operating level. The settlement period to query can be specified as a date and settlement period, or as a datetime which will resolve to the settlement period that time falls within. If a settlement period is provided, it will take precedence over the time portion of the datetime. - [Run Down Rate Export](https://developers.modoenergy.com/reference/run-down-rate-export.md): This endpoint provides Run Down Rate Export data received from NGESO. Run Down Rate Export (RDRE) expresses the rate of decrease in active power production (MW/minute) for a particular BM Unit which is exporting power within a particular operating range. There can be up to three of these for a given BM Unit. - [Run Down Rate Import](https://developers.modoenergy.com/reference/run-down-rate-import.md): This endpoint provides Run Down Rate Import data received from NGESO. Run Down Rate Import (RDRI) expresses the rate of increase in active power consumption (MW/minute) for a particular BM Unit which is importing power within a particular operating range. There can be up to three of these for a given BM Unit. - [Run Up Rate Export](https://developers.modoenergy.com/reference/run-up-rate-export.md): This endpoint provides Run Up Rate Export data received from NGESO. Run Up Rate Export (RURE) expresses the rate of increase in active power production (MW/minute) for a particular BM Unit which is exporting power within a particular operating range. There can be up to three of these for a given BM Unit. - [Run Up Rate Import](https://developers.modoenergy.com/reference/run-up-rate-import.md): This endpoint provides Run Up Rate Import data received from NGESO. Run Up Rate Import (RURI) expresses the rate of decrease in active power consumption (MW/minute) for a particular BM Unit which is importing power within a particular operating range. There can be up to three of these for a given BM Unit. - [Stable Export Limit](https://developers.modoenergy.com/reference/stable-export-limit.md): This endpoint provides Stable Export Limit data received from NGESO. Stable Export Limit is a positive megawatt value, expressing the minimum stable operating level at which a particular BM Unit can export power to the transmission system. - [Stable Import Limit](https://developers.modoenergy.com/reference/stable-import-limit.md): This endpoint provides Stable Import Limit data received from NGESO. Stable Import Limit is a negative megawatt value, expressing the minimum stable operating level at which a particular BM Unit can import power from the transmission system. - [System Frequency](https://developers.modoenergy.com/reference/system-frequency.md): The endpoint provides data that has been received every 2 minutes the Transmission System Frequency, expressed as a hertz value for one or more spot times within that 2 minute period. The default output will be the latest published data. - [System Price and NIV (DISEBSP)](https://developers.modoenergy.com/reference/system-price-and-niv-disebsp.md): System price and net imbalance volume (NIV) values per settlement period calculated by Elexon. - [System Warnings (SYSWARN)](https://developers.modoenergy.com/reference/system-warnings-syswarn.md): Systems warnings data from Elexon Insights. - [Temperature Data](https://developers.modoenergy.com/reference/temperature-data.md): This endpoint provides the average degree celsius value measured at midday deemed to be representative of the temperature for Great Britain. Data is gathered from 6 weather stations. Default output will be the last 31 days. Values are received from 5pm each day. - [Total Load Forecast per Bidding Zone - Day-Ahead (DATL)](https://developers.modoenergy.com/reference/total-load-forecast-per-bidding-zone-day-ahead-datl.md): Day-ahead total load forecast data for GB (the “bidding zone”), with a maximum range of 7 days in the future. Data received from Elexon Insights. - [Wind and Solar Generation Forecast - Day-Ahead (DGWS)](https://developers.modoenergy.com/reference/wind-and-solar-generation-forecast-day-ahead-dgws.md): Day-ahead generation forecast for wind and solar in GB. Data received from Elexon Insights. - [Wind Generation Forecast](https://developers.modoenergy.com/reference/wind-generation-forecast.md): This endpoint provides wind generation forecast data. - [EPEX DA Half-Hourly](https://developers.modoenergy.com/reference/epex-da-half-hourly.md): Day-ahead half-hourly auction from EPEX. This information comes from EPEX FTP - [EPEX DA Hourly](https://developers.modoenergy.com/reference/epex-da-hourly.md): Day-ahead hourly auction from EPEX. This information comes from EPEX FTP - [EPEX IDA1 results](https://developers.modoenergy.com/reference/epex-ida1-results.md): Results from the EPEX intraday half-hourly auction. This endpoint describes the first intraday auction of the day, IDA1, which runs at 17:30 UTC the day before delivery. This information comes from EPEX FTP - [EPEX IDA2 results](https://developers.modoenergy.com/reference/epex-ida2-results.md): Results from the EPEX intraday half-hourly auction. This endpoint describes the first intraday auction of the day, IDA2, which runs at 08:00 UTC on the day of delivery. There are prices and volumes from 11am - 11pm only. This information comes from EPEX FTP. - [EPEX Intraday Reference Price EOD](https://developers.modoenergy.com/reference/epex-intraday-reference-price-eod.md): EPEX's calculation of reference price index for trades of products up to 4h in duration (RPD) and reference price index for half-hour product trades (RPD HH) for each half-hour period of the day. This is calculated by EPEX and released on their FTP at the end of the day. - [EPEX Live Continuous Intraday Contract Info Report](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-contract-info-report.md): All contracts on the EPEX Continuous Intra Day market (GB) - [EPEX Live Continuous Intraday Detailed Trades](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-detailed-trades.md): Details of trades in the EPEX Continuous Intraday market (GB) - calculated live by Modo Energy as a combination of the Trade Confirmation and Contract Info Reports. - [EPEX Live Continuous Intraday OHLC](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-ohlc.md): OHLC (Open, High, Low, Close) values for trades of half-hour duration only, for each half-hour settlement period. Calculated live by Modo Energy. - [EPEX Live Continuous Intraday Public Trade Confirmation Report](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-public-trade-confirmation-report.md): All executed trades on the EPEX Continuous Intra Day market (GB) - live data. - [EPEX Live Continuous Intraday Reference Price HH](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-reference-price-hh.md): Reference price (RPD) index for trades of half-hour duration in the EPEX Continuous Intraday market (GB), for each half-hour settlement period. Calculated live by Modo Energy. - [EPEX Live Continuous Intraday Reference Price](https://developers.modoenergy.com/reference/epex-live-continuous-intraday-reference-price.md): RPD (reference price) index for all trades up to and including 4 hours in duration (volume weighted) in the EPEX Continuous Intra day market (GB), for each half-hour settlement period. Calculated live by Modo Energy. - [EPEX Live Continuous Order Book](https://developers.modoenergy.com/reference/epex-live-continuous-order-book.md): The order books for every contract traded on the EPEX Continuous Intra Day market (GB). Each order book contains every open and unfulfilled order for a specific Intra Day Continuous market contract. Updated in real time by Modo Energy as orders are added, updated, or removed (by the owner or because a trade is executed). - [Adjusted COP snapshot - RTM](https://developers.modoenergy.com/reference/adjusted-cop-snapshot-rtm.md): Complete Current Operating Plan (COP) data for each QSE snapshot on each hour; confidentiality expired 60 day data. - [All COP updates - RTM](https://developers.modoenergy.com/reference/all-cop-updates-rtm.md): All iterative Current Operating Plan (COP) submissions where a change has occurred for the operating day. 60-day delayed data. - [Ancillary service requirements - DAM](https://developers.modoenergy.com/reference/ancillary-service-requirements-dam.md): Ancillary Service requirements by type and quantity for each hour of the current day plus the next 6 days - [Ancillary Services Cleared Volumes - DAM](https://developers.modoenergy.com/reference/ancillary-services-cleared-volumes-dam.md): Cleared volume data for the day-ahead market ancillary services. The data gives the actual volumes traded for each market, for self-arranged and cleared trades. This data is on a 2-day delay. - [Ancillary services clearing prices - DAM](https://developers.modoenergy.com/reference/ancillary-services-clearing-prices-dam.md): The Market Clearing Prices for Capacity for all Ancillary Services from the Day-Ahead Market for the last thirty days on a daily basis. - [Ancillary services obligations and responsibilities - DAM](https://developers.modoenergy.com/reference/ancillary-services-obligations-and-responsibilities-dam.md): Ancillary Service Obligation and Ancillary Service Supply Responsibility for each QSE, 180 days after the Operating Day - [Ancillary Services Offers - DAM](https://developers.modoenergy.com/reference/ancillary-services-offers-dam.md): Offer data for the day-ahead market ancillary services. The data gives the prices and volumes offered in each market. This data is on a 2-day delay. - [Average solar power production by geographical region - System-wide](https://developers.modoenergy.com/reference/average-solar-power-production-by-geographical-region-system-wide.md): System-wide and geographic regional 5-minute averaged solar power production for a rolling historical 60-minute period. - [Average solar power production - System-wide](https://developers.modoenergy.com/reference/average-solar-power-production-system-wide.md): System-wide actual 5-minute averaged solar power production for On-Line PVGRs for a rolling historical 60-minute period. - [Average wind power production by geographical region - System-wide](https://developers.modoenergy.com/reference/average-wind-power-production-by-geographical-region-system-wide.md): System-wide and Geographic Regional actual 5-minute averaged wind power production for a rolling historical 60-minute period. - [Average wind power production - System-wide](https://developers.modoenergy.com/reference/average-wind-power-production-system-wide.md): System-wide and Regional actual 5-min averaged wind power production for a rolling historical 60-minute period. - [DAM - Point-to-point obligation bids](https://developers.modoenergy.com/reference/dam-point-to-point-obligation-bids.md): Details of all settlement point point-to-point bids. - [DAM - Point-to-point obligation offer awards](https://developers.modoenergy.com/reference/dam-point-to-point-obligation-offer-awards.md): Details of all awarded settlement point point-to-point options. - [DAM - Point-to-point obligation offers](https://developers.modoenergy.com/reference/dam-point-to-point-obligation-offers.md): Details of all settlement point point-to-point options. - [Demand - System-wide](https://developers.modoenergy.com/reference/demand-system-wide.md): Aggregated ERCOT system actual demand by 15-minute interval, for the most recent hour. - [Dynamically scheduled resource and loads - RTM](https://developers.modoenergy.com/reference/dynamically-scheduled-resource-and-loads-rtm.md): Details on dynamically scheduled resource and loads in the ERCOT real-time market. 60-day delayed data. - [Electrical bus mapping](https://developers.modoenergy.com/reference/electrical-bus-mapping.md): A current list of all Settlement Points that may be used for market processes and transactions mapping list. - [Energy Bids - DAM](https://developers.modoenergy.com/reference/energy-bids-dam.md): Details of all energy bids in the ERCOT day-ahead market. 60-day delayed data. - [Energy offers - DAM](https://developers.modoenergy.com/reference/energy-offers-dam.md): Details of all energy offers in the ERCOT day-ahead market. 60-day delayed data. - [Energy prices (Historical) - RTM](https://developers.modoenergy.com/reference/energy-prices-historical-rtm.md): Historical RTM Settlement Point Prices (SPPs) for each of the Hubs and Load Zones. - [Energy Storage Resources Operations](https://developers.modoenergy.com/reference/energy-storage-resources-operations.md): The combined real-time physical operations of all Energy Storage Resources in ERCOT. - [Energy Bid Awards - DAM](https://developers.modoenergy.com/reference/energybidawards_dam.md): Details of all energy bid awards in the ERCOT day-ahead market. 60-day delayed data. - [Energy Offer Awards - DAM](https://developers.modoenergy.com/reference/energyonlyofferawards_dam.md): Details of all energy offer awards in the ERCOT day-ahead market. 60-day delayed data. - [Generation resources Settled Metered Net Energy - RTM](https://developers.modoenergy.com/reference/gen_res_60d_sced_smne.md): Details of Settled Metered Net Energy for generation resources in the ERCOT real-time market. 60-day delayed data. - [Generation resource data - RTM](https://developers.modoenergy.com/reference/gen_resource_data_60d_sced.md): Details of all generation resources in the ERCOT real-time market. 60-day delayed data. - [Generation Resource Data - DAM](https://developers.modoenergy.com/reference/gen_resource_data_dam.md): Details of all generation resources in the ERCOT day-ahead market. 60-day delayed data. - [Gen-specific ancillary service offer awards - SASM](https://developers.modoenergy.com/reference/gen-specific-ancillary-service-offer-awards-sasm.md): Details of all awarded ancillary service offers for generation resources in the ERCOT supplementary ancillary service market. 60-day delayed data. - [Gen-specific ancillary service offers - DAM](https://developers.modoenergy.com/reference/gen-specific-ancillary-service-offers-dam.md): Details of all ancillary service offers for generation resources in the ERCOT day-ahead market. 60-day delayed data. - [Gen-specific ancillary service offers - SASM](https://developers.modoenergy.com/reference/gen-specific-ancillary-service-offers-sasm.md): Details of all ancillary service offers for generation resources in the ERCOT supplementary ancillary service market. 60-day delayed data. - [Generation Fuel Mix](https://developers.modoenergy.com/reference/generation-fuel-mix.md): The fuel-mix of ERCOT generation in MW. - [HDL and LDL manual override summary - RTM](https://developers.modoenergy.com/reference/hdl-and-ldl-manual-override-summary-rtm.md): HDL and LDL manual overrride summary in the ERCOT real-time market. 60-day delayed data. - [Historical ancillary service prices - DAM](https://developers.modoenergy.com/reference/historical-ancillary-service-prices-dam.md): Historical DAM Clearing Prices for Capacity - [Historical energy prices - DAM](https://developers.modoenergy.com/reference/historical-energy-prices-dam.md): Historical DAM Settlement Point Prices (SPPs) for each of the Hubs and Load Zones - [Load Resource Data - DAM](https://developers.modoenergy.com/reference/load_resource_data_dam.md): Details of all load resources in the ERCOT day-ahead market. 60-day delayed data. - [Load resource data - RTM](https://developers.modoenergy.com/reference/load_resource_data_in_sced_60d.md): Details of all load resources in the ERCOT real-time market. 60-day delayed data. - [Load-specific ancillary service offer awards - SASM](https://developers.modoenergy.com/reference/load-specific-ancillary-service-offer-awards-sasm.md): Details of all awarded ancillary service bids for generation resources in the ERCOT supplementary ancillary service market. 60-day delayed data. - [Load-specific ancillary service offers - DAM](https://developers.modoenergy.com/reference/load-specific-ancillary-service-offers-dam.md): Details of all ancillary service offers for load resources in the ERCOT day-ahead market. 60-day delayed data. - [Load-specific ancillary service offers - SASM](https://developers.modoenergy.com/reference/load-specific-ancillary-service-offers-sasm.md): Details of all ancillary service bids for generation resources in the ERCOT supplementary ancillary service market. 60-day delayed data. - [ORDC and Reliability Deployment price adders and Reserves (real-time, SCED intervals) - RTM](https://developers.modoenergy.com/reference/ordc-and-reliability-deployment-price-adders-and-reserves-real-time-sced-intervals-rtm.md): This dataset updates every 5 minutes with each SCED run, and has various measures of system reserves. It also shows the price adders and system lambda. This report will not be updated after 2025-12-05, due to being discontinued at source. - [ORDC and Reliability Deployment prices (real-time, 15-minute intervals) - RTM](https://developers.modoenergy.com/reference/ordc-and-reliability-deployment-prices-real-time-15-minute-intervals-rtm.md): This dataset shows the Real-Time reserve price adders for both on-line [RTRSVPOR] and off-line reserves [RTRSVPOFF], as well as the on-line reliability deployment price adders [RTRDP] for each 15 minute settlement interval. This report will not be updated after 2025-12-05, due to being discontinued at source. - [ORDC prices (Historical, 15-minute intervals) - RTM](https://developers.modoenergy.com/reference/ordc-prices-historical-15-minute-intervals-rtm.md): Historical Real-Time ORDC and Reliability Deployment Prices for 15-minute Settlement Interval. This report will not be updated after 2025-12-05, due to being discontinued at source. - [ORDC prices (Historical, SCED timestamp) - RTM](https://developers.modoenergy.com/reference/ordc-prices-historical-sced-timestamp-rtm.md): Historical Real-Time ORDC and Reliability Deployment Price Adders and Reserves. This report will not be updated after 2025-12-05, due to being discontinued at source. - [Point-to-point obligation bid awards - DAM](https://developers.modoenergy.com/reference/point-to-point-obligation-bid-awards-dam.md): Details of all awarded settlement point point-to-point bids. - [QSE-specific self-arranged ancillary services - DAM](https://developers.modoenergy.com/reference/qse-specific-self-arranged-ancillary-services-dam.md): Details of all self arranged ancillary service obligations between QSEs. - [QSE-specific self-arranged ancillary services - RTM](https://developers.modoenergy.com/reference/qse-specific-self-arranged-ancillary-services-rtm.md): Details of all QSE-specific self-arranged ancillary services in the ERCOT real-time market. - [Solar power production - hourly averaged actual and forecasted - System-wide](https://developers.modoenergy.com/reference/solar-power-production-hourly-averaged-actual-and-forecasted-system-wide.md): System-wide actual hourly averaged solar power production. - [Settlement Point Prices - DAM](https://developers.modoenergy.com/reference/spp_prices_dam.md): Settlement Point Price for all Resource Nodes, Load Zones and Trading Hubs from the Day-Ahead market in ERCOT. - [Settlement Point Prices - RTM](https://developers.modoenergy.com/reference/spp_prices.md): Settlement Point Price for each Settlement Point at resource nodes, hubs and load. Produced from SCED LMPs every 15 minutes. - [Total ancillary service offers - DAM](https://developers.modoenergy.com/reference/total-ancillary-service-offers-dam.md): The total quantity in MW of Offers per Ancillary Service per hour from the Day-Ahead Market for the last thirty days on a daily basis - [Wind power production - hourly averaged actual and forecasted - System-wide](https://developers.modoenergy.com/reference/wind-power-production-hourly-averaged-actual-and-forecasted-system-wide.md): System-wide and Geographic Regional actual hourly averaged wind power production. - [BESS Industry Growth - ERCOT](https://developers.modoenergy.com/reference/bess-industry-growth-ercot.md): This endpoint is deprecated. Please use Index Capacity Timeseries instead. - [BESS Industry Growth - GB](https://developers.modoenergy.com/reference/bess-industry-growth-gb.md): This endpoint is deprecated. Please use Index Capacity Timeseries instead. - [Daily ME BESS GB](https://developers.modoenergy.com/reference/daily-me-bess-gb.md): Live average daily revenue benchmark for GB battery assets. This endpoint is deprecated, please use the [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries) and the [Index Capacity Timeseries](https://developers.modoenergy.com/reference/index-capacity-timeseries) endpoints to get the same data with more customisation. - [Index List](https://developers.modoenergy.com/reference/index-list-deprecated.md): Retrieves a list of all available indices, including custom indices and those created by Modo Energy. Note: Custom indices for GB and ERCOT are accessible, but Modo Energy's GB and ERCOT indices are currently unavailable on this endpoint. This endpoint is deprecated, please use [Index List](https://developers.modoenergy.com/reference/index-list) - [Index Revenue](https://developers.modoenergy.com/reference/index-revenue-deprecated.md): Retrieves aggregated revenue data for a specific index over a defined date range. Deprecated, please use [Index Revenue](https://developers.modoenergy.com/reference/index-revenue) - [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries-deprecated.md): Retrieves time-series revenue data for a specific index over a defined time range. Deprecated, please use [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries) endpoint instead. - [ME BESS ERCOT](https://developers.modoenergy.com/reference/me-bess-ercot.md): Modo Energy battery revenue index in ERCOT for each delivery interval. 60-day delayed data. This endpoint is now deprecated, please see the [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries) and the [Index Capacity Timeseries](https://developers.modoenergy.com/reference/index-capacity-timeseries) endpoints to get the same data with more customisation. - [Monthly ME BESS GB](https://developers.modoenergy.com/reference/monthly-me-bess-gb.md): Live average monthly revenue benchmark for GB battery assets. This endpoint is deprecated, please see the [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries) and the [Index Capacity Timeseries](https://developers.modoenergy.com/reference/index-capacity-timeseries) endpoints to get the same data with more customisation. - [Asset Revenue By Index](https://developers.modoenergy.com/reference/asset-revenue-by-index.md): Retrieves aggregated revenue data for all assets within a specific index over a specified time range. - [Asset Revenues by Index Timeseries](https://developers.modoenergy.com/reference/asset-revenues-by-index-timeseries.md): Retrieves time-series revenue data for assets associated with a specific index over a defined period. - [ERCOT Battery Benchmark (Nowcast)](https://developers.modoenergy.com/reference/ercot-battery-benchmark-nowcast.md): The ERCOT Battery Benchmark bridges the gap in the 60-day disclosure data from ERCOT, for real-time insight into battery market revenues. This is Modo's provisional estimate of daily fleet-wide battery revenue based on live market-wide data. This endpoint is now deprecated and has not been updated since 2025-09-01. - [Index Capacity Timeseries](https://developers.modoenergy.com/reference/index-capacity-timeseries.md): Retrieves index capacity for a specific index over a defined date range as a timeseries. - [Index List](https://developers.modoenergy.com/reference/index-list.md): Retrieves a list of all available indices, including custom indices and those created by Modo Energy. - [Index Revenue Timeseries](https://developers.modoenergy.com/reference/index-revenue-timeseries.md): Retrieves total index revenue for a specific index over a defined date range as a timeseries. - [Index Revenue](https://developers.modoenergy.com/reference/index-revenue.md): Retrieves total index revenue for a specific index over a defined date range. - [Live Detailed System Price](https://developers.modoenergy.com/reference/live-detailed-system-price.md): Details of every balancing action taken by National Grid ESO in the Balancing Mechanism for each settlement period. Includes fields used to calculate system price and NIV. For the current settlement period, this dataset represents all the actions taken so far by National Grid ESO, and is not a forecast for the end of the settlement period. This endpoint is deprecated, and any missing data will not be backfilled. - [Live NIV](https://developers.modoenergy.com/reference/live-niv.md): Modo Energy's live calculation of net imbalance volume (NIV). This is the volume sum of all balancing actions taken by National Grid ESO in the Balancing Mechanism for each settlement period. For the current settlement period, this dataset represents all the actions taken so far by National Grid ESO, and is not a forecast for the end of the settlement period. This endpoint is deprecated, and any missing data will not be backfilled. - [Live System Price](https://developers.modoenergy.com/reference/live-system-price.md): Modo Energy's live calculation of system price. For the current settlement period, this dataset represents all the actions taken so far by National Grid ESO, and is not a forecast for the end of the settlement period. This endpoint is deprecated, and any missing data will not be backfilled. - [Balancing](https://developers.modoenergy.com/reference/balancing.md): National Grid ESO procures balancing service contracts to balance demand and supply and to ensure the security and quality of electricity supply across Britain's transmission system. For some of the balancing services contracts which fall within trading timescales, (i.e. several days ahead to a couple of hours ahead) the trading team will evaluate all the possible balancing actions including trading and balancing services, and take the most cost-effective actions. If the balancing services contract provides the best solution, the contract will be enacted. The balancing service contracts come in different shapes and forms. We are grouping some of the contract enactment here which typically has relative similar structure or price are fixed at the time of the decision. For example, it can be for constraint management in Scotland, or deliver reactive power requirement. Usually, the balancing service contract enactment doesn't have the physical exchange of power or energy, the balancing services contracts that are not enacted by trading team are not included here. - [Boundaries DNO](https://developers.modoenergy.com/reference/boundaries-dno.md): This dataset contains approximate GIS (geographic information system) geospatial boundaries for each of the DNO License Areas in Great Britain. There are 14 licensed Distribution Network Operators (DNOs) in Britain and each is responsible for a regional distribution services area. DNO License Areas are sometimes referred to as GSP Groups and historically have also been known as Public Electricity Supplier (PES) regions, though the latter name is no longer widely used. The DNO License Area boundaries are unusual because they are only well defined when tested. The boundaries tend to run through rural areas and change over time whenever a new connection is added close to a boundary. For example, a new connection close to an existing boundary can approach the DNO responsible for both neighbouring License Areas to ask for a connection, and is free to choose either depending on how much they will charge - once the new connection is made the boundary is, theoretically, re-drawn to ensure that the new connection falls into the correct License Area. The boundaries in this dataset were shared by Western Power Distribution (the DNO responsible for 4 of the 14 License Areas) and come with the disclaimer that they are probably a little outdated and not 100% accurate. That said, they are a good indication of the geography of DNO License Areas. DNO License Areas are widely used as an aggregation entity when reporting electricity network data, for example, in Elexon's publication of electricity settlement data. As such, they are also useful for regional modelling of the GB electricity transmission network, for example to aggregate distributed embedded generator energy flows onto the transmission network. - [Boundaries Supply](https://developers.modoenergy.com/reference/boundaries-supply.md): This dataset contains approximate GIS (Geographic Information System) geospatial boundaries associated with each of the Grid Supply Points (GSPs) on the GB transmission network. The boundaries have been derived by generating Thiessen polygons around the lowest level grid asset for which we have a topological lookup back to GSP. In some cases, this means Thiessen polygons have been generated around Distribution Network Operator (DNO) assets (e.g. Bulk Supply Points, Primary Substations etc) and these Thiessen polygons have been aggregated up to GSP level using topological lookups provided by the DNOs, in other cases no DNO asset GIS data was available in time for the dataset release and the GSP boundary is a single Thiessen polygon. The GSP boundaries have been clipped to the DNO Licence Area boundaries, except where GIS data from DNOs provided evidence of a DNO serving demand in a neighbouring DNO Licence Area through bilateral agreement with the neighbour DNO. The GSP boundaries are used for regional modelling of the GB electricity transmission network, for example to aggregate distributed embedded generator energy flows onto the transmission network. This includes the regional FES analysis (https://www.nationalgrideso.com/future-energy/future-energy-scenarios/regionalisation-fes) and the Regional PV_Live outturn estimates published by The University of Sheffield (https://www.solar.sheffield.ac.uk/pvlive/regional/). There are multiple versions of the GIS boundaries, with older versions maintained here for posterity. The latest version of the GIS boundaries is 20220314. The 20181031 version of the dataset includes a lookup between GSPs and so-called Gnodes and Direct Connects. Gnodes are an entity used by teams within National Grid ESO for the purposes of modelling and monitoring the transmission network. In most cases there is a 'ONE : ONE' relationship between 'GSP : Gnode', but occasionally a Gnode can represent several GSPs ('ONE Gnode : MANY GSPs') and in some cases a Gnode represents an asset on the distribution network. In general, the relationship between GSPs and Gnodes is 'MANY : MANY'. A Direct Connect represents demand connected directly to the transmission network. They are included in this dataset because they may theoretically host embedded generation and/or may form part of a MANY:MANY relationship with a Gnode. The 20220114 version of the dataset contains only GSPs and does not include mappings between GSPs, Gnodes and Direct Connects. Some GSPs have been grouped together because it was not possible to discern which geographical regions they each serve. - [BR Buy Orders](https://developers.modoenergy.com/reference/br-buy-orders.md): Details of all buy orders submitted by NG ESO in the Balancing Reserve service. - [BR Results by Unit](https://developers.modoenergy.com/reference/br-results-by-unit.md): Details of all units accepted to provide the Positive and Negative Balancing Reserve services. - [BR Results Summary](https://developers.modoenergy.com/reference/br-results-summary.md): Details of all clearing prices and accepted volumes for each settlement period in the Positive and Negative Balancing Reserve services. - [BR Sell Orders](https://developers.modoenergy.com/reference/br-sell-orders.md): Details of all sell orders submitted by market participants in the Balancing Reserve EAC system. - [BSUOS Forecast](https://developers.modoenergy.com/reference/bsuos-forecast.md): This file contains the Electricity System Operator's (ESO) half-hourly BSUoS forecast (Balancing Services Use of System charge). The estimated BSUoS charge is calculated by taking the forecast half-hourly balancing costs divided by the forecast BSUoS volume. - [BSUOSII](https://developers.modoenergy.com/reference/bsuosii.md): Calculated BSUoS charge for lnterim Information (II). These are updated daily with the actual Half Hourly BSUoS price. Total costs and volume information by settlement period is also published here. - [BSUOSRF](https://developers.modoenergy.com/reference/bsuosrf.md): Calculated BSUoS charge for Reconciliation Final (RF). These are updated daily with the actual Half Hourly BSUoS price. Total costs and volume information by settlement period is also published here. - [BSUOSSF](https://developers.modoenergy.com/reference/bsuossf.md): Calculated BSUoS charge for Settlement Final (SF). These are updated daily with the actual Half Hourly BSUoS price. Total costs and volume information by settlement period is also published here. - [Constraints Cost Volume](https://developers.modoenergy.com/reference/constraints-cost-volume.md): The publication consists of constraint breakdown information to provide additional transparency of why as ESO we are taking actions on the system. Please note that tags applied to actions can occasionally be changed post event and in this instance the information in this dataset would be refreshed to reflect the up to date information. - [Constraints Day Ahead](https://developers.modoenergy.com/reference/constraints-day-ahead.md): A snapshot of the limits and flows at relevant boundaries at day ahead stage. These flow values are true for when the measurement was taken and will not reflect any changes in the flows following the publication of this data. The network diagrams show the constraint boundaries and arrows indicating the positive direction of power flow across each boundary. - [Constraints Thermal Costs](https://developers.modoenergy.com/reference/constraints-thermal-costs.md): Thermal constraints are taken when the amount of energy that would flow naturally from one region to another exceeds the capacity of the circuits connecting the two regions. This dataset provides outturn system costs for thermal constraints across a number of significant constraint boundaries. - [Day-ahead Wind Forecast](https://developers.modoenergy.com/reference/day-ahead-wind-forecast.md): The dataset contains national wind forecast over a day ahead timescale as well as all historic day ahead wind forecasts to assist the industry to make efficient decisions in balancing their supply and demand positions. - [DT-BOA](https://developers.modoenergy.com/reference/dt-boa.md): This dataset is a component of the Forward Plan 2020-21 commitment to increase the transparency of our operational decision making in the Balancing Mechanism (BM). It includes the publication of actions taken in the BM, reasons for them and includes a methodology document for the process. - [DX Block Orders](https://developers.modoenergy.com/reference/dx-block-orders.md): Details of all block orders submitted by market participants in the Dynamic Containment, Dynamic Moderation, and Dynamic Regulation auctions, between 2021-09-15 until 2023-11-02. This dataset is no longer being updated, and has been replaced by DX Sell Orders and DX Buy Orders. - [DX Buy Orders](https://developers.modoenergy.com/reference/dx-buy-orders.md): Details of all buy orders submitted by NG ESO in the Dynamic Containment, Dynamic Moderation, and Dynamic Regulation auctions in the new EAC system. - [DX Results By Unit](https://developers.modoenergy.com/reference/dx-results-by-unit.md): Details of all units accepted to provide the Dynamic Containment, Dynamic Moderation, and Dynamic Regulation services. - [DX Results Summary](https://developers.modoenergy.com/reference/dx-results-summary.md): Details of all clearing prices and accepted volumes in the Dynamic Containment, Dynamic Moderation, and Dynamic Regulation services. - [DX Sell Orders](https://developers.modoenergy.com/reference/dx-sell-orders.md): Details of all sell orders submitted by market participants in the Dynamic Containment, Dynamic Moderation, and Dynamic Regulation auctions in the new EAC system. - [Embedded Register](https://developers.modoenergy.com/reference/embedded-register.md): A list of connected or contracted to connect embedded generation projects in Scotland - [Forecast Carbon](https://developers.modoenergy.com/reference/forecast-carbon.md): This dataset contains national carbon intensity forecast for the GB electricity system. The carbon intensity of electricity is a measure of how much CO2 emissions are produced per kilowatt hour of electricity consumed. - [Forecast DC 4D](https://developers.modoenergy.com/reference/forecast-dc-4d.md): The dataset contains forecasts of our Dynamic Containment Low and High requirements for the next 4-days. The methodology uses forecasted demand, inertia, and response volumes as well as a view of the largest losses on the system to estimate the DC requirements. The actual requirements day-ahead are likely to change based on optimisation carried out closer to real-time coupled with greater visibility of inertia, demand, and loss sizes. For example, changes to interconnector flows from our forecasted position can lead to either an increase or decrease in our requirements if the change impacts the largest loss we need to secure. - [Forecast Demand 2D](https://developers.modoenergy.com/reference/forecast-demand-2d.md): This dataset contains national electricity demand forecast for 2 days ahead as well as all historic 2 day ahead demand forecasts. The forecast assist the industry to make efficient decisions in balancing their supply and demand positions. - [Forecast Demand 7D](https://developers.modoenergy.com/reference/forecast-demand-7d.md): This dataset contains national electricity demand forecast for 7 days ahead as well as all historic 7 day ahead demand forecasts. The forecast assist the industry to make efficient decisions in balancing their supply and demand positions. - [Forecast Renewables](https://developers.modoenergy.com/reference/forecast-renewables.md): Electricity System Operator (ESO) publishes at a half-hourly resolution the embedded (refer to embedded document for definition) wind and solar forecast from within day up to 14 days ahead. - [Forecast Wind 14D](https://developers.modoenergy.com/reference/forecast-wind-14d.md): This dataset provides incremental updates for 0-14 days ahead wind forecasts at half hourly level. The forecast assist the industry to make efficient decisions in balancing their supply and demand positions. - [Gas](https://developers.modoenergy.com/reference/gas.md): Daily and rolling average System Average Price (SAP) of gas traded in Great Britain. The SAP price is the average price for gas traded via the OCM (On-the-day Commodity Market) mechanism. - [GIS Boundaries for GB Generation Charging Zones](https://developers.modoenergy.com/reference/gis-boundaries-for-gb-generation-charging-zones.md): This dataset contains approximate GIS (geographic information system) geospatial boundaries for each of the TNUoS generation zones in Great Britain. There are 27 TNUoS generation zones, and each is associated with a set of generation zonal tariffs. The total number of TNUoS generation zones may change over time. In addition, the boundaries tend to flex over time when a new substation is added close to a boundary. Once we identify an existing substation that is the closest neighbour to the new substation (the 'distance' is measured by site-specific incremental MWkm), the boundary is, theoretically, re-drawn to ensure that the new substation falls into the same generation zone that contains its nearest neighbouring substation. The boundaries are indicative and come with the disclaimer that they are not 100% accurate. That said, they are a good indication of the geography of TNUoS generation zones. In the event of any inconsistencies between the shapefiles and the CUSC, the TNUoS tariff reports or the NGESO Use of System Charging Statements, then the CUSC, the TNUoS tariff reports or the NGESO Use of System Charging Statements will take precedence. For the TNUoS demand zones shapefiles, please refer to https://api.nationalgrideso.com/dataset/gis-boundaries-for-gb-dno-license-areas - [Historic Data AS](https://developers.modoenergy.com/reference/historic-data-as.md): Details of all units accepted to provide the Low-frequency Dynamic Containment service and historic clearing prices before 16 September 2021. This is prior to the auction moving to EFA block procurement. - [Inertia](https://developers.modoenergy.com/reference/inertia.md): This dataset contains an estimate of the outturn inertia and market provided inertia for Great Britain Transmission System. - [Interconnectors IFA2](https://developers.modoenergy.com/reference/interconnectors-ifa2.md): These are the values System Operators use to restrict the maximum import and export Interconnector flows. These values are submitted in MW per GMT hourly time period - [Linear Orders](https://developers.modoenergy.com/reference/linear-orders.md): Details of all Dynamic Containment, Dynamic Regulation & Dynamic Moderation Linear Orders. - [TEC Register](https://developers.modoenergy.com/reference/tec-register.md): A list of projects that hold contracts for Transmission Entry Capacity (TEC) with us. These include existing and future connection projects and projects that can be directly connected to the National Electricity Transmission System (NETS), or make use of it. - [Upcoming Trades](https://developers.modoenergy.com/reference/upcoming-trades.md): This dataset displays all upcoming GTMA (Grid Trade Master Agreement) trades due to be delivered on the National Grid ESO network. This is in order to meet forecast. This data is provisional and subject to correction. - [WFFR Block Orders](https://developers.modoenergy.com/reference/wffr-block-orders.md): Details of all block orders submitted by market participants in the weekly Firm Frequency Response auctions. - [WFFR Linear Orders](https://developers.modoenergy.com/reference/wffr-linear-orders.md): Details of all weekly Firm Frequency Response Linear Orders. - [WFFR Results Summary](https://developers.modoenergy.com/reference/wffr-results-summary.md): Details of all clearing prices and accepted volumes in the weekly Firm Frequency Response service. - [WFFR Results Unit](https://developers.modoenergy.com/reference/wffr-results-unit.md): Details of all units accepted to provide the weekly Firm Frequency Response. - [N2EX GB Block Orders](https://developers.modoenergy.com/reference/n2ex-gb-block-orders.md): Details of all block orders submitted by GB market participants in the N2EX day-ahead hourly auction. - [N2EX GB Prices](https://developers.modoenergy.com/reference/n2ex-gb-prices.md): Clearing price details of all block orders in the GB N2EX day-ahead hourly auction. - [N2EX GB Volumes](https://developers.modoenergy.com/reference/n2ex-gb-volumes.md): Details of volumes of all block orders in the GB N2EX day-ahead hourly auction. - [Nord Pool European Block Orders](https://developers.modoenergy.com/reference/nord-pool-european-block-orders.md): Details of all block orders submitted by market participants in the European Nord Pool day-ahead hourly auction. This includes the regions of Central/Western Europe (CWE) and the Nordics. - [Nord Pool European Prices](https://developers.modoenergy.com/reference/nord-pool-european-prices.md): Clearing price details of all block orders in the European Nord Pool day-ahead hourly auction. This includes the regions of Central/Western Europe (CWE) and the Nordics. - [Nord Pool European Purchase Volume](https://developers.modoenergy.com/reference/nord-pool-european-purchase-volume.md): Details of purchase volumes of all block orders in the European Nord Pool day-ahead hourly auction. This includes the regions of Central/Western Europe (CWE) and the Nordics. - [Nord Pool European Sales Volume](https://developers.modoenergy.com/reference/nord-pool-european-sales-volume.md): Details of sales volumes of all block orders in the European Nord Pool day-ahead hourly auction. This includes the regions of Central/Western Europe (CWE) and the Nordics. - [Nord Pool European Volume](https://developers.modoenergy.com/reference/nord-pool-european-volume.md): Details of all block orders submitted by market participants in the European Nord Pool day-ahead hourly auction. This includes the regions of Central/Western Europe (CWE) and the Nordics. - [Get List Of Ercot Forecast Runs (Deprecated)](https://developers.modoenergy.com/reference/get_v1-forecasts-ercot-forecasts-list.md): Pull a list of all of the pre-populated Zonal revenue forecasts for ERCOT. - [Get Forecast Run (Deprecated)](https://developers.modoenergy.com/reference/get_v1-forecasts-forecasts-id.md): Pull Modo Energy revenue forecasts.In order to use this endpoint you need to know the IDs of the forecasts that you’re looking to pull. - [Get List Of Forecast Runs (Deprecated)](https://developers.modoenergy.com/reference/get_v1-forecasts-forecasts.md): Pull a list of all of the revenue forecasts generated by your team. This request will provide a list of IDs. You can then use the “Get Forecast Run” endpoint to pull the forecast. - [Get List Of GB Forecast Runs (Deprecated)](https://developers.modoenergy.com/reference/get_v1-forecasts-gb-forecasts-list.md): Pull a list of all of the pre-populated revenue forecasts for Great Britain. - [Get Macro Scenario List (Deprecated)](https://developers.modoenergy.com/reference/get_v1-forecasts-macro-scenarios.md) - [Create Forecast Run (Deprecated)](https://developers.modoenergy.com/reference/post_v1-forecasts-run-simulation.md): Create a revenue forecast using the Modo Energy forecasting model. - [List of Regions for Live PV (PES or GSP)](https://developers.modoenergy.com/reference/list-of-regions-for-live-pvpes-or-gsp.md): List of PES/GSP regions in GB used for the Live PV endpoint - [Solar Generation in GB](https://developers.modoenergy.com/reference/solar-generation-in-gb.md): This endpoint provides information on the historical and live generation of solar energy in Great Britain - [Virtual assets List](https://developers.modoenergy.com/reference/virtual-assets-list.md): Retrieves a list of all available virtual assets, including custom assets and those created by Modo Energy. - [Virtual assets Retrieve](https://developers.modoenergy.com/reference/virtual-assets-retrieve.md): Retrieves details of a specific virtual asset by ID. - [Virtual assets Revenue](https://developers.modoenergy.com/reference/virtual-assets-revenue.md): Virtual asset revenue endpoint. Returns the revenue for a virtual asset over a given time range and markets, with optional granularity and normalisation. - [Create Forecast Run](https://developers.modoenergy.com/reference/create_forecast_run.md): Submit a new custom forecast simulation run. Select your market region from the dropdown below to see the required and optional configuration fields for that region. - [Get Forecast Run Results](https://developers.modoenergy.com/reference/get_forecast_run_results.md): Returns results for a completed forecast run at the requested resolution. Results are returned in column-oriented format: each entry in `columns` has a `label`, a `display_label`, and a `data` array of length `periods`. Timestamps are implicit — derive them from `data_start`, the resolution, and the array index. Use `?columns=` to request a subset of columns by label. Omit the parameter to return all available columns. Returns 404 if the run has not yet completed. Poll `GET /runs/{id}/` until `status` is `ready_for_review` before calling this endpoint. - [Get Forecast Run](https://developers.modoenergy.com/reference/get_forecast_run.md): Returns detail for a single forecast run. Poll this endpoint until `status` is `ready_for_review`, then call `GET /runs/{id}/results/{resolution}/` to retrieve results. - [List Config Schemas](https://developers.modoenergy.com/reference/list_config_schemas.md): Returns all simulation config schemas, newest first. Each schema describes the `simulation_config` payload accepted by `POST /runs/` for that region, along with the `api_version` to include in your request. Use `?latest_only=true` to return only the most recent schema per region. Use `?market_region=` to filter to a specific region. - [List Custom Files](https://developers.modoenergy.com/reference/list_custom_files.md): Returns the custom files your company has uploaded, newest first. Use a file's `filename` to reference it in your `simulation_config` when creating a run via `POST /runs/`. Filter with `?file_type=`. - [List Forecast Runs](https://developers.modoenergy.com/reference/list_forecast_runs.md): Returns a paginated list of forecast runs for your company, ordered newest first by default. Each item includes the original `simulation_config` submitted at creation. Use `GET /runs/{id}/results/{resolution}/` to retrieve results for a completed run. Filtering: combine any of the query parameters below — they are AND'd together. `*__in` parameters accept comma-separated values. Date filters accept any ISO 8601 datetime, e.g. `2026-01-01T00:00:00Z`. - [List Nodes](https://developers.modoenergy.com/reference/list_nodes.md): Returns the list of valid pricing nodes for a market region. Use the `name` field to populate the `nodes` field in your `simulation_config` when creating a nodal forecast run via `POST /runs/`. Requires `?region=` to select the market region and `?list_type=` to select the forecast or backtest node list. Supports `?search=` to filter nodes by name. - [Upload Custom File](https://developers.modoenergy.com/reference/upload_custom_file.md): Upload a custom CSV file to use in a forecast run, such as a battery degradation curve, a solar or wind generation profile, or grid charges/curtailment limits. The file is validated on upload (CSV only, max 20 MB, and the column structure must match the selected `file_type`); invalid files are rejected with a 400 describing the problem. **How to use the result:** take the `filename` from the response and reference it in your `simulation_config` when calling `POST /runs/`. For example, a `degradation_curve` upload goes in `simulation_config.assets.battery.degradation.profile_filename`. Send the request as `multipart/form-data`. ## Recipes - [Add a Balancing Reserve flag to Balancing Mechanism actions](https://developers.modoenergy.com/recipes/add-a-balancing-reserve-flag-to-balancing-mechanism-actions.md) - [Calculate fleet capacity by owner/operator](https://developers.modoenergy.com/recipes/calculate-fleet-capacity-by-owneroperator.md) - [Calculate ratio of BMUs to non-BMUs](https://developers.modoenergy.com/recipes/calculate-ratio-of-bmus-to-non-bmus.md) - [Calculate rolling EPEX continuous trading price](https://developers.modoenergy.com/recipes/calculate-rolling-epex-continuous-trading-price.md) - [Calculating EPEX buy/sell curves](https://developers.modoenergy.com/recipes/calculating-epex-buysell-curves.md) - [Create BOA time series](https://developers.modoenergy.com/recipes/create-boa-time-series.md) - [Download the current GB asset database](https://developers.modoenergy.com/recipes/download-the-current-gb-asset-database.md) - [Example Modo Energy API client](https://developers.modoenergy.com/recipes/example-modo-energy-api-client.md) - [Get historic snapshot of the EPEX order book](https://developers.modoenergy.com/recipes/get-historic-snapshot-of-the-epex-order-book.md) - [How to use the Index Revenue Timeseries endpoint](https://developers.modoenergy.com/recipes/how-to-use-the-index-revenue-timeseries-endpoint.md) - [Using the Index Revenue endpoint to get revenue by market](https://developers.modoenergy.com/recipes/using-the-index-revenue-endpoint-to-get-revenue-by-market.md) - [Using the Index Revenue endpoint](https://developers.modoenergy.com/recipes/using-the-index-revenue-endpoint.md) - [Using the Index Revenue Timeseries endpoint to get revenue by market](https://developers.modoenergy.com/recipes/using-the-index-revenue-timeseries-endpoint-to-get-revenue-by-market.md) ## Changelog - [2026-05-18 | ERCOT asset database schema updates](https://developers.modoenergy.com/changelog/changelog-2026-05-18.md) - [2026-05-15 | Australia NEM asset breakdown nullable MLF](https://developers.modoenergy.com/changelog/changelog-2026-05-15.md) - [2026-05-06 | Forecast and GB market endpoints restored](https://developers.modoenergy.com/changelog/changelog-2026-05-06.md) - [2026-05-12 | Australia asset schema updates](https://developers.modoenergy.com/changelog/changelog-2026-05-12.md) - [2026-05-05 | GB market screens live endpoints deprecated](https://developers.modoenergy.com/changelog/changelog-2026-05-05.md)