Skip to main content

REST API History - Get executions for open positions

Get executions for open positions

Written by Albert
Updated over 2 weeks ago

Get executions for open positions

POST /frontoffice/api/v4/positions/executions/list

Summary

Use this method to retrieve execution details for multiple open positions by providing an array of position identifiers.

Request

Header parameters

accountId required

The trading account identifier.

Body

positionIds array · string[]

The array of position identifiers.

limit integer · int32 | nullable

The maximum number of items to return.

Request example

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

{
"positionIds": [
"01K2PMT0VMJG5B8XBDNZ7FNM1F",
"01K2PMXY63HESK110WT1CHMAFA"
],
"limit": 5
}

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": "01K2PMXY63HESK110WT1CHMAFA",
"orderId": "01K2PMXY1894RC6E2BYFR00T87",
"side": "Buy",
"reason": "Trader",
"createdAt": "2025-08-15T10:38:10.627Z",
"executionId": "01K2PMXY63NXM30VNWPDECSFJR",
"baseAmount": "15",
"executionPrice": "4333.69288",
"commissionAmountInRAT": "32.27",
"commissions": [
{
"assetId": "eur",
"amount": "32.27"
}
]
},
{
"positionId": "01K2PMT0VMJG5B8XBDNZ7FNM1F",
"orderId": "01K2PMT0KRRMTTXGPDJCXZ99NZ",
"side": "Buy",
"reason": "Trader",
"createdAt": "2025-08-15T10:36:02.292Z",
"executionId": "01K2PMT0VMPCZW0JB2C9J6B405",
"baseAmount": "0.141",
"executionPrice": "4602.3",
"commissionAmountInRAT": "5",
"commissions": [
{
"assetId": "eur",
"amount": "5"
}
]
}
]
}

Did this answer your question?