Energy Trade (ET)

An EnergyTrade describes a scheduled trade of energy between a buyer and a seller at a specified settlement point. The following diagram describes the structure of an Energy Trade:

EnergyTrade Structure

Within an EnergyTrade is an EnergySchedule. Energy Schedules are defined using the TmSchedule type, where intervals may be up to 15 minutes in granularity. This is shown in the following diagram:

EnergySchedule Structure

In order for a trade to be accepted, both the buyer and seller must submit matching trades, as identified using the buyer and seller tags. On submission, the following table describes the items used for an EnergyTrade:

startTime
endTime
buyer (QSE ID)
seller (QSE ID)
sp (settlement point name)
EnergySchedule

Element	Req?	Datatype	Description	Values
startTime	K	dateTime	Start time for bid	Valid start hour boundary for trade date
endTime	K	dateTime	End time for bid	Valid end hour boundary for trade date
externalId	N	String	External ID	QSE supplied
sp	K	String	Settlement point	Valid settlement point name
buyer	K	String	Trade buyer	Valid QSE
seller	K	String	Trade seller	Valid QSE
tradeID	N	String	reserved for future use
EnergySchedule/startTime	N	dateTime	not used	not used
EnergySchedule/endTime	N	dateTime	not used	not used
EnergySchedule/ TmPoint/time	Y	dateTime	Absolute time for start of 15 minute interval	Valid time in the trading date
EnergySchedule/ TmPoint/ending	N	dateTime	Absolute time for end of 15 minute interval	Valid time in the trading date
EnergySchedule/ TmPoint/value1	Y	float	Megawatts	>= 0
EnergySchedule/ TmPoint/netTrade	N	string	Trade description	Purchase (“P”) or Sale (“S”) for DSR resources.

The following is an XML example for an EnergyTrade:

<BidSet xmlns="http://www.ercot.com/schema/2007-06/nodal/ews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ercot.com/schema/2007-06/nodal/ews ErcotTransactions.xsd">
    <tradingDate>2008-01-01</tradingDate>
    <status/>
    <mode/>
    <EnergyTrade>
        <startTime>2008-01-01T00:00:00-05:00</startTime>
        <endTime>2008-01-02T00:00:00-05:00</endTime>
        <marketType>DAM</marketType>
        <buyer>AEN</buyer>
        <seller>LCRA</seller>
        <tradeID>TradeID123</tradeID>
        <sp>JUDKINS_8</sp>
        <EnergySchedule>
            <TmPoint>
                <time>2008-01-01T00:00:00-05:00</time>
                <ending>2008-01-02T00:00:00-05:00</ending>
                <value1>89</value1>
            </TmPoint>
        </EnergySchedule>
    </EnergyTrade>
</BidSet>

And the corresponding response:

<ns1:BidSet xmlns:ns1="http://www.ercot.com/schema/2007-06/nodal/ews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ercot.com/schema/2007-06/nodal/ews ErcotTransactions.xsd">
    <ns1:tradingDate>2008-06-14</ns1:tradingDate>
    <ns1:EnergyTrade>
        <ns1:mRID>AEN.20080614.ET.JUDKINS_8.AEN.LCRA</ns1:mRID>
        <ns1:status>ACCEPTED</ns1:status>
        <ns1:error>
            <ns1:severity>INFORMATIVE</ns1:severity>
            <ns1:text>Successfully processed the ERCOT Energy Trade.</ns1:text>
        </ns1:error>
    </ns1:EnergyTrade>
</ns1:BidSet>