Skip to content

ERCOT External Web Services (EWS)

  1. Document Revisions

  2. Introduction

    1. Purpose

    2. Scope

    3. Definitions, Acronyms, and Abbreviations

    4. References

    5. Program-level Standards

  3. Services Organization

    1. Common Message Structure

    2. Message Header

      1. Request Message Structures

      2. Payload Structures

      3. Response Message Structures

    3. Common Security Implementation

      1. Secure the Transport layer

      2. Secure SOAP messages

    4. Modeling and Conventions

      1. Use of the IEC CIM

      2. Representation of Time

      3. Market Products

      4. Management and Use of Transaction IDs (mRIDs)

      5. Other Conventions

      6. Precision

      7. XML Special Characters

    5. Delivery Approach

    6. Technical Interoperability

    7. Service Level Agreements

    8. Auditing, Monitoring and Management

    9. Versioning

    10. Governance

    11. Web Service Configuration Standards

    12. Web Service Design Assumptions and Limitations

  4. Market Transaction Service

    1. Interfaces Provided

    2. Interfaces Required

    3. Message Specifications

      1. Three-Part Supply Offer (TPO)

      2. Self-Arranged Ancillary Service Quantities (SAA)

      3. Incremental and Decremental Energy Offer Curves (IDO)

      4. Ancillary Service Offer (ASO)

      5. Ancillary Service Trade (AST)

      6. Availability Plan (AVP)

      7. Capacity Trade (CT)

      8. Current Operating Plan (COP)

      9. DAM Energy Bid (EB)

      10. DAM Energy-Only Offer (EOO)

      11. Energy Trade (ET)

      12. Output Schedule (OS)

      13. PTP Obligation Bid (PTP)

      14. Self-Schedule (SS)

      15. Real-Time Market Energy Bid (REB)

      16. Exceptional Fuel Cost (EFC)

      17. Ancillary Service Only Offer (AOO)

    4. Error Handling

    5. Usage and XML Samples

      1. Offer and Bid Set Submission

      2. Querying Bids, Offers, Trades and Schedules

      3. Updating Bids, Offers, Trades and Schedules

      4. Canceling Bids, Offers, Trades and Schedules

  5. Market Information

    1. Interfaces Provided

    2. Interfaces Required

      1. AwardSet

      2. AwardedAS

      3. AwardedCRR

      4. AwardedEnergyBid

      5. AwardedEnergyOffer

      6. AwardedEnergyOnlyOffer

      7. AwardedPTPObligation

      8. AwardedASOnly

      9. Forecasted Load

      10. System Load - Same as Total ERCOT Load

      11. Market Totals - Same as Total DAM Energy

      12. Market LMPs, SPPs and Price Corrections

      13. Market MCPCs

      14. Binding Constraints

      15. SCED Violated Constraints

      16. Price Corrected SCED Violated Constraints

      17. Ancillary Service Obligation

      18. Dynamic Ratings

      19. Load Ratio Share

      20. Aggregated Ancillary Service Offer Curves

      21. Ancillary Service Plan

      22. Startup and Shutdown Instructions

      23. Total Ancillary Service Offers

      24. Total DAM Energy - Same as Market Totals

      25. Weather Data

      26. Responsive Reserve Capacity - See System Parameters

      27. Non-Spinning Reserve - See System Parameters

      28. Undeployed Reg-Up and Reg-Down - See System Parameters

      29. Available Capacity - See System Parameters

      30. Wind-Powered Generation Resource Production Potential

      31. Short-Term Wind Power Forecast

      32. Total ERCOT Load - Same as System Load

      33. Total ERCOT Generation Operating Reserve - See System Parameters

      34. UnconfirmedTrades

      35. ConfirmedTrades

      36. DAM Ancillary Service Offer Insufficiency Report

      37. End of Adjustment Period Results

      38. Two Hour Warning Results

      39. DAM Phase II Validation Results

      40. System Parameters

      41. RTD Indicative Base Points

      42. RTD Indicative LMPs

      43. SCED ORDC Price Adders

      44. RT Price Adder ORDC

      45. RTD Indicative ORDC Price Adders

      46. Photovoltaic Generation Resource Production Potential

      47. Short-Term Photovoltaic Power Forecast

      48. Price Corrected SOTG/SODG 15-min Prices

      49. Price Corrected SOTG/SODG LMPs

  6. Notifications

    1. Interfaces Provided

    2. Interfaces Required

    3. Message Specifications

      1. Offer and Bid Set Acceptance

      2. Offer and Bid Set Errors

      3. Confirmed and Unconfirmed Trades

      4. Energy Offer Awards

      5. DAM Energy-Only Offer Awards

      6. DAM Energy Bid Awards

      7. Ancillary Service Awards

      8. CRR Awards

      9. PTP Obligation Awards

      10. Ancillary Service Obligations

      11. Outage Notifications

      12. Startup/Shutdown Instructions

      13. Wind Generation Forecast

      14. DAM Ancillary Service Offer Insufficiency Report

      15. End of Adjustment Period Results

      16. Two Hour Warning Results

      17. DAM Phase II Validation Results

      18. Solar Generation Forecast

    4. Notices and Alerts

      1. MMS System-Generated Notices

      2. EMS System-Generated Notices

      3. NMMS System-Generated Notices

      4. Operator Notices

  7. Outage Scheduling Interfaces

    1. Interfaces Provided

    2. Message Specifications

      1. Outage Creation

      2. Outage Query

      3. Outage Update

      4. Outage Cancellation

  8. Utility Interfaces

    1. Interfaces Provided

      1. Get mRID

      2. System Status

      3. Request Test Notification

      4. Change Active Notification URL

      5. Get SASM ID List

  9. Reports

    1. GetReports

  10. Resource Parameter Transaction Service

    1. Interfaces Provided

      1. Querying for Resource Parameters Set

      2. Updating Resource Parameters Set

      3. Canceling Resource Parameters Set

    2. Message Specifications

      1. Generator Resource Parameters

      2. Controllable Load Resource Parameters

      3. Non Controllable Load Resource Parameters

      4. Resource Parameters

  11. Verbal Dispatch Instructions

    1. Interfaces Provided

    2. Interfaces Required

    3. Message Specifications

      1. Verbal Dispatch Instructions Structure

  12. Get Notifications

    1. Message Specification

  13. Appendices

    1. Appendix A: WS-Notifications

    2. Appendix B: WSDL for Market Requests

    3. Appendix C: XML Schemas for Message and Payload Definitions

    4. Appendix D: Annotated SOAP Message

    5. Appendix E: SOAP Examples

    6. Appendix F: XSL Examples

    7. Appendix G: Payload Compression Example

    8. Appendix H: DST XML Examples