Skip to main content

REST API History - Get executions for a closing order

Get executions for a closing order

Written by Albert
Updated over 2 weeks ago

Get executions for a closing order

POST /frontoffice/api/v5/orders/{orderId}/executions/list

Summary

Use this method to retrieve execution details for a specific position-closing order using its identifier.

Request

Header parameters

accountId required

The trading account identifier.

Path parameters

orderId required

The order identifier.

Body

positionId string | nullable

The position identifier.

limit integer Β· int32 | nullable

The maximum number of items to return.

lastExecutionId string | nullable

The identifier of the final execution to be returned.

Request example

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

{
"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 amount of the base asset.

executionPrice decimal string

The price at which the execution was settled.

realizedPnlInRAT decimal string

The realized PnL, in conversion to RAT.

commissionAmountInRAT decimal string

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

commissions array

The breakdown of commissions charged per asset.

Structure:

  • assetId string

  • amount decimal string

positionSizeIncreased boolean

Indicates if a position size was increased (true) or decreased (false) as a result of the execution.

isExceeded boolean

Indicates whether the number of returned items reached the response limit and more data is available.

Response example β€” 200: OK

{
"executions": [
{
"positionId": "string",
"orderId": "string",
"side": "Buy",
"reason": "Trader",
"createdAt": "2025-12-18T19:02:22.196Z",
"executionId": "string",
"baseAmount": "string",
"executionPrice": "string",
"realizedPnlInRAT": "string",
"commissionAmountInRAT": "string",
"commissions": [
{
"assetId": "string",
"amount": "string"
}
],
"positionSizeIncreased": true
}
],
"isExceeded": true
}


Did this answer your question?