Skip to content
Clear Street Clear Street
Start Trading
API Reference
V1
Orders

Get Executions

client.V1.Orders.GetExecutions(ctx, accountID, query) (*V1OrderGetExecutionsResponse, error)
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
accountID int64
query V1OrderGetExecutionsParams
From param.Field[Time]Optional

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

formatdate-time
InstrumentID param.Field[InstrumentIDOrSymbol]Optional

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

formatuuid
PageSize param.Field[int64]Optional

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

formatint64
maximum1000
minimum1
PageToken param.Field[string]Optional

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

formatbyte
To param.Field[Time]Optional

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

formatdate-time
ReturnsExpand Collapse
type V1OrderGetExecutionsResponse struct{…}
ID string

Unique identifier for this execution report.

formatuuid
InstrumentID string

Unique instrument identifier.

formatuuid
OrderID string

Identifier of the order this execution belongs to.

formatuuid
Price string

Fill price.

Quantity string

Filled quantity.

Side Side

Side of the fill.

One of the following:
const SideBuy Side = "BUY"
const SideSell Side = "SELL"
const SideSellShort Side = "SELL_SHORT"
const SideOther Side = "OTHER"
Symbol string

Trading symbol.

TransactionTime Time

Transaction timestamp in nanosecond precision (UTC).

formatdate-time

Get Executions

package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.Orders.GetExecutions(
    context.TODO(),
    0,
    clearstreet.V1OrderGetExecutionsParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", 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"
    }
  ]
}