Skip to content

Get trade by ID

Request

Returns a single trade record as JSON.

How to use: provide the product type and a trade id of the trade you want to return.

Path
productstringrequired

Product scope. "XBID" covers XBID and Intraday; "EXPOST", "GOPACS" and "INTRADAY" each cover only themselves; ALL covers every product.

Enum:"XBID""REGULAR""EXPOST""GOPACS""INTRADAY""ALL"
tradeIdstring, non-emptyrequired

Identifier of the trade to return.

GET
/public-api/4.0/electricity/reporting/{product}/trades/{tradeId}
curl -i -X GET \
  'https://acc-trading.etpa.nl/public-api/4.0/electricity/reporting/{product}/trades/{tradeId}'

Responses

Success. JSON trade record: a regular trade (RegularTradeDto, for Intraday/Ex-post), a Gopacs trade (GopacsTradeDto) or an XBID trade (XbidTradeDto).

Bodyapplication/json
One of:

Trade representation for the regular (non-XBID) markets. Returned for Gopacs, Intraday and Ex-post trades. Extends the base trade with the EANs of the underlying buy and sell orders. All base trade fields also apply. Fields that are null are omitted from the response.

idstringrequired

Unique internal identifier of this trade record.

productstringrequired

Market/product the trade belongs to.

Enum:"XBID""EXPOST""GOPACS""INTRADAY"
buyerIdstring

Identifier of the buying participant.

buyerNamestring

Human-readable name of the buying participant.

buyerIndividualIdstring

Identifier of the individual (trader) on the buy side.

buyerIndividualNamestring

Human-readable name of the individual (trader) on the buy side.

sellerIdstring

Identifier of the selling participant.

sellerNamestring

Human-readable name of the selling participant.

sellerIndividualIdstring

Identifier of the individual (trader) on the sell side.

sellerIndividualNamestring

Human-readable name of the individual (trader) on the sell side.

startinteger, (int64)

Delivery period start, in epoch milliseconds (UTC).

endinteger, (int64)

Delivery period end, in epoch milliseconds (UTC).

transactionDateinteger, (int64)

Timestamp at which the trade occurred, in epoch milliseconds (UTC).

pricenumber

Price of the trade (EUR/MWh).

capacitynumber

Traded capacity (MW).

mwhTradednumber

Traded energy (MWh), rounded to 3 decimal places.

totalPricenumber

Total price of the trade (EUR).

unitPricenumber

Price per unit (EUR/MWh).

buyOrderMetadataobject

Free-form key/value metadata of the buy order that produced this trade.

sellOrderMetadataobject

Free-form key/value metadata of the sell order that produced this trade.

revertedbooleanrequired

Whether the trade has been reverted.

tradeIdstringrequired

Business identifier of the trade.

buyerBrpParticipantIdstring

BRP participant identifier on the buy side, when applicable.

sellerBrpParticipantIdstring

BRP participant identifier on the sell side, when applicable.

buyOrderEanstring

EAN (connection identifier) of the facility on the buy order.

sellOrderEanstring

EAN (connection identifier) of the facility on the sell order.

Response
{
  "id": "string",
  "product": "XBID",
  "buyerId": "string",
  "buyerName": "string",
  "buyerIndividualId": "string",
  "buyerIndividualName": "string",
  "sellerId": "string",
  "sellerName": "string",
  "sellerIndividualId": "string",
  "sellerIndividualName": "string",
  "start": 0,
  "end": 0,
  "transactionDate": 0,
  "price": 0,
  "capacity": 0,
  "mwhTraded": 0,
  "totalPrice": 0,
  "unitPrice": 0,
  "buyOrderMetadata": {
    "property1": "string",
    "property2": "string"
  },
  "sellOrderMetadata": {
    "property1": "string",
    "property2": "string"
  },
  "reverted": true,
  "tradeId": "string",
  "buyerBrpParticipantId": "string",
  "sellerBrpParticipantId": "string",
  "buyOrderEan": "string",
  "sellOrderEan": "string"
}