Get executions for an open position

POST /frontoffice/api/v4/positions/{positionId}/executions/list

Summary

Use this method to retrieve execution details for a specific open position using its position identifier.

Request

Header parameters

accountId required

The trading account identifier.

Path parameters

positionId required

The position identifier.

Body

limit integer · int32 | nullable

The maximum number of items to return.

offset integer · int32 | nullable

The number of items to skip before starting to collect the result set.

Request example

POST /frontoffice/api/v4/positions/01K2PMT0VMJG5B8XBDNZ7FNM1F/executions/list HTTP/1.1
Host: {host}
Authorization: Bearer JWT
accountId: {accountId}
Content-Type: application/json; x-api-version=4.0
Accept: */*

{
  "limit": 2,
  "offset": 0
}

Response

In case of success, an object containing an array of executions will be returned.

Each execution object contains the following information:

positionId string

The position identifier.

orderId string

The order identifier.

side string

The execution side.

Possible values:

Buy
Sell

reason string

The reason for the execution.

Possible values:

Trader
StopOut
MarketHalted
MarketDisabled
TakeProfit
StopLoss
Admin

createdAt string

The date and time when the execution occurred, in the following format: YYYY-MM-DDTHH:MM:SS.sssZ.

executionId string

The execution identifier.

baseAmount decimal string

The executed base asset amount.

executionPrice decimal string

The price at which the execution was settled.

commissionAmountInRAT decimal string

The total commissions charged for the execution, in conversion to RAT.

commissions array

The breakdown of commissions charged per asset.

Response example — 200: OK

{
  "executions": [
    {
      "positionId": "01K2PMT0VMJG5B8XBDNZ7FNM1F",
      "orderId": "01K2PMT0KRRMTTXGPDJCXZ99NZ",
      "side": "Buy",
      "reason": "Trader",
      "createdAt": "2025-08-15T10:36:02.293Z",
      "executionId": "01K2PMT0VNWB23GSRN2XQAJD6Q",
      "baseAmount": "0.314",
      "executionPrice": "4603.5",
      "commissionAmountInRAT": "0",
      "commissions": []
    },
    {
      "positionId": "01K2PMT0VMJG5B8XBDNZ7FNM1F",
      "orderId": "01K2PMT0KRRMTTXGPDJCXZ99NZ",
      "side": "Buy",
      "reason": "Trader",
      "createdAt": "2025-08-15T10:36:02.293Z",
      "executionId": "01K2PMT0VN1F2JPM14AEV6V8YJ",
      "baseAmount": "0.045",
      "executionPrice": "4603.49",
      "commissionAmountInRAT": "0",
      "commissions": []
    }
  ]
}

REST API History - Get executions for an open position