Skip to content
Clear Street Clear Street Clear Street
Start Trading
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_ids: Optional[Sequence[str]]

Comma-separated instrument identifiers (UUIDs) or symbols (e.g. AAPL) to filter by. When provided, only executions for any of the listed instruments are returned.

order_ids: Optional[Sequence[str]]

Comma-separated order IDs to filter by. When provided, only executions belonging to an order in this set are returned.

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
underlying_instrument_ids: Optional[Sequence[str]]

Comma-separated instrument IDs (UUID) or symbols (equity tickers or OSI option symbols). Matches option fills whose resolved underlier is any of the given instruments.

ReturnsExpand Collapse
class OrderGetExecutionsResponse: …
id: str

Unique identifier for this execution report.

formatuuid
order_id: str

Identifier of the order this execution belongs to.

formatuuid
quantity: str

Filled quantity.

side: Side

Side of the fill.

One of the following:
"BUY"
"SELL"
transaction_time: datetime

Transaction timestamp in nanosecond precision (UTC).

formatdate-time
instrument_id: Optional[str]

Unique instrument identifier. null when this fill has no single resolvable instrument. When a null/undefined value is observed, it indicates it does not apply.

formatuuid
price: Optional[str]

Fill price. null for multileg fills, whose price lives only at the leg level. When a null/undefined value is observed, it indicates it does not apply.

symbol: Optional[str]

Trading symbol. null when this fill has no single resolvable instrument. When a null/undefined value is observed, it indicates it does not apply.

underlying_instrument_id: Optional[str]

Underlying instrument identifier for an option fill. Omitted for a non-derivative fill, when the underlier could not be resolved, or for a multileg fill (per-leg underliers live in legs[]). When a null/undefined value is observed, it indicates it does not apply.

formatuuid
underlying_instrument_type: Optional[SecurityType]

Type of the underlying instrument, alongside underlying_instrument_id. When a null/undefined value is observed, it indicates it does not apply.

One of the following:
"COMMON_STOCK"
"INDEX"
"OPTION"
"CASH"
venue: Optional[str]

Venue where this fill occurred, as reported by that venue. Distinct from an order’s venue, which is the routing destination. Codes are not normalized, so the format varies by venue. When a null/undefined value is observed, it indicates that there is no available data.

Get Executions

from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.orders.get_executions(
    account_id=0,
)
print(response)
{
  "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"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}
Returns Examples
{
  "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"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}