Skip to content
Get started

Get Executions

$ clst v1:orders get-executions
GET/v1/accounts/{account_id}/executions

Retrieves filled and partially-filled execution reports for the specified trading account, ordered by transaction time (nanosecond precision) descending.

ParametersExpand Collapse
--account-id: number

Account identifier

--from: optional string

The start date and time for the query range, inclusive (ISO 8601 format)

--instrument-id: optional string

Optional instrument to filter by. Accepts either a symbol (e.g. AAPL) or an OEMS instrument UUID.

--page-size: optional number

The number of items to return per page. Only used when page_token is not provided.

--page-token: optional string

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

--to: optional string

The end date and time for the query range, inclusive (ISO 8601 format)

ReturnsExpand Collapse
V1OrderGetExecutionsResponse: BaseResponse { metadata, error }
data: array of Execution { id, instrument_id, order_id, 5 more }
id: string

Unique identifier for this execution report.

instrument_id: string

OEMS instrument identifier.

order_id: string

Identifier of the order this execution belongs to.

price: string

Fill price.

quantity: string

Filled quantity.

side: "BUY" or "SELL" or "SELL_SHORT" or "OTHER"

Side of the fill.

"BUY"
"SELL"
"SELL_SHORT"
"OTHER"
symbol: string

Trading symbol.

transaction_time: string

Transaction timestamp in nanosecond precision (UTC).

Get Executions

clst v1:orders get-executions \
  --api-key 'My API Key' \
  --account-id 0
{
  "metadata": {
    "request_id": "request_id",
    "next_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "page_number": 0,
    "previous_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "total_items": 0,
    "total_pages": 0
  },
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero",
    "details": [
      {
        "foo": "bar"
      }
    ]
  },
  "data": [
    {
      "id": "019d216d-9857-7e23-ae01-edc07126c9e4",
      "instrument_id": "528ec5c3-cdbf-447c-b995-ec6c83cfbc02",
      "order_id": "01928b4d-c000-7000-8000-000000000001",
      "price": "150.25",
      "quantity": "100",
      "side": "BUY",
      "symbol": "AAPL",
      "transaction_time": "2026-03-24T19:58:43.798000Z"
    }
  ]
}
Returns Examples
{
  "metadata": {
    "request_id": "request_id",
    "next_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "page_number": 0,
    "previous_page_token": "U3RhaW5sZXNzIHJvY2tz",
    "total_items": 0,
    "total_pages": 0
  },
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero",
    "details": [
      {
        "foo": "bar"
      }
    ]
  },
  "data": [
    {
      "id": "019d216d-9857-7e23-ae01-edc07126c9e4",
      "instrument_id": "528ec5c3-cdbf-447c-b995-ec6c83cfbc02",
      "order_id": "01928b4d-c000-7000-8000-000000000001",
      "price": "150.25",
      "quantity": "100",
      "side": "BUY",
      "symbol": "AAPL",
      "transaction_time": "2026-03-24T19:58:43.798000Z"
    }
  ]
}