Skip to content
Clear Street Clear Street
Get started
API Reference
V1
Orders

Get Executions

v1.orders.get_executions(intaccount_id, OrderGetExecutionsParams**kwargs) -> OrderGetExecutionsResponse
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: int
from_: Optional[Union[str, datetime]]

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

formatdate-time
instrument_id: Optional[InstrumentIDOrSymbol]

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

formatuuid
page_size: Optional[int]

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

formatint64
maximum1000
minimum1
page_token: Optional[Union[str, Base64FileInput]]

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

formatbyte
to: Optional[Union[str, datetime]]

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

formatdate-time
ReturnsExpand Collapse
class OrderGetExecutionsResponse: …
id: str

Unique identifier for this execution report.

formatuuid
instrument_id: str

OEMS instrument identifier.

formatuuid
order_id: str

Identifier of the order this execution belongs to.

formatuuid
price: str

Fill price.

quantity: str

Filled quantity.

side: Side

Side of the fill.

One of the following:
"BUY"
"SELL"
"SELL_SHORT"
"OTHER"
symbol: str

Trading symbol.

transaction_time: datetime

Transaction timestamp in nanosecond precision (UTC).

formatdate-time

Get Executions

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.orders.get_executions(
    account_id=0,
)
print(response)
{
  "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"
    }
  ]
}