Skip to content

Trades v3

NOTE: The Trades v3 endpoints makes use of the pagination 2.0.

Trades v3 provides endpoints to retrieve trade information. It supports fetching all trades with pagination and sorting by latest first, as well as retrieving a specific trade by its tradeId.

Operations

Get Trades

Request

The endpoint makes use of the pagination 2.0. It will allow you to retrieve all trades sorted by latest first

Security
api-key
Query
pageNumberinteger, (int32)

Number of page to return.

Default:0
pageSizeinteger, (int32), [ 1 .. 100 ]

Number of trades to return. A number between 1 and 100.

Default:10
my_own_tradesboolean

Return only your own trades or only trades that are not yours. A trade is considered your own trade if you were the buyer or the seller.

participantIdstring

Filter on participantId. This is only useful for brokers.

orderIdstring

Filter on orderId.

tradeIdstring

Filter on tradeId.

startinteger, (int64), >= 0

Return trades created after the given timestamp. Value must be a Unix timestamp in milliseconds.

endinteger, (int64), >= 0

Return trades created before the given timestamp. Value must be a Unix timestamp in milliseconds.

fieldstring

The field to filter on start and/or end if specified

Default:"EXECUTED"
Enum:"START""END""EXECUTED"
timeblocksstring

Filter on timeblocks.

Enum:"INTRADAY""EXPOST""GOPACS"
GET
/public-api/3.0/electricity/trades
curl -i -X GET \
  'https://acc-trading.etpa.nl/public-api/3.0/electricity/trades?pageNumber=0&pageSize=10&my_own_trades=true&participantId=string&orderId=string&tradeId=string&start=0&end=0&field=START&timeblocks=INTRADAY' \
  -H 'api_key: YOUR_API_KEY_HERE'

Responses

Requested trades

Body*/*
totalElementsinteger, (int64)
totalPagesinteger, (int32)
sizeinteger, (int32)
contentArray of objects(TradeApiResponse)
numberinteger, (int32)
sortobject(SortObject)
firstboolean
lastboolean
numberOfElementsinteger, (int32)
pageableobject(PageableObject)
emptyboolean
Response
{
  "totalElements": 0,
  "totalPages": 0,
  "size": 0,
  "content": [
    {
      "id": "string",
      "tradeId": "string",
      "productType": "ELECTRICITY",
      "timeblock": "BASELOAD",
      "buyerId": "string",
      "sellerId": "string",
      "orderIdBuy": "string",
      "orderIdSell": "string",
      "buyerEan": "string",
      "sellerEan": "string",
      "buyTraderName": "string",
      "sellTraderName": "string",
      "buyOrderMetadata": {
        "property1": "string",
        "property2": "string"
      },
      "sellOrderMetadata": {
        "property1": "string",
        "property2": "string"
      },
      "quantity": 0,
      "start": 1694422800000,
      "end": 1694422800000,
      "executed": 1694422800000,
      "duration": 0,
      "mwhTraded": 0,
      "price": 0,
      "type": "string",
      "tradedForIdcons": true,
      "reverted": true,
      "revertedAt": 1694422800000
    }
  ],
  "number": 0,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "first": true,
  "last": true,
  "numberOfElements": 0,
  "pageable": {
    "offset": 0,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "paged": true,
    "pageSize": 0,
    "pageNumber": 0,
    "unpaged": true
  },
  "empty": true
}