Skip to content

Total DAM Energy

Total DAM Energy - Same as Market Totals

This section describes interfaces used to retrieve the total amount of energy bought or sold in the Day Ahead Market. This interface will return the full day data for DAM market for the requesting day.

The request message would use the following message fields:

Message Element Value
Header/Verb get
Header/Noun TotalEnergys
Header/Source Market participant ID
Header/UserID ID of user
Request/option

One of:

  • EnergyBoughtInDAM

  • EnergySoldInDAM

Request/OperatingDate Day of interest

The corresponding response messages would use the following message fields:

Message Element Value
Header/Verb reply
Header/Noun TotalEnergys
Header/Source ERCOT
Reply/ReplyCode Reply code, success=OK, error=ERROR or FATAL
Reply/Error Error message, if error encountered
Payload/ TotalEnergy

The payload structure is described by the following diagram:

TotalEnergys Structure

TotalEnergy Structure

The Totals structure is based upon a CIM RegularIntervalSchedules, where the values of ‘value1’ are total megawatt values.

The following is an XML example:

<ns0:TotalEnergys xmlns:ns0="http://www.ercot.com/schema/2007-06/nodal/ews">
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T00:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-13T01:00:00-05:00</ns0:ending>
            <ns0:value1>0</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>DEF_PUN1</ns0:sp>
    </ns0:TotalEnergy>
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T00:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-13T01:00:00-05:00</ns0:ending>
            <ns0:value1>0</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>ABCD_CC1</ns0:sp>
    </ns0:TotalEnergy>
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T00:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-13T01:00:00-05:00</ns0:ending>
            <ns0:value1>0</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>ABC_PUN1</ns0:sp>
    </ns0:TotalEnergy>
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T00:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-13T01:00:00-05:00</ns0:ending>
            <ns0:value1>37</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>FGH_ABC_G1</ns0:sp>
    </ns0:TotalEnergy>
    ...
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T23:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-14T00:00:00-05:00</ns0:ending>
            <ns0:value1>0</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>RST_CC1</ns0:sp>
    </ns0:TotalEnergy>
    <ns0:TotalEnergy>
        <ns0:TmPoint>
            <ns0:time>2009-06-13T23:00:00-05:00</ns0:time>
            <ns0:ending>2009-06-14T00:00:00-05:00</ns0:ending>
            <ns0:value1>0</ns0:value1>
        </ns0:TmPoint>
        <ns0:sp>MN_PUN1</ns0:sp>
    </ns0:TotalEnergy>
</ns0:TotalEnergys>