List non-trade activities

client.V1.Accounts.GetNonTradeActivities(ctx, accountID, query) (*V1AccountGetNonTradeActivitiesResponse, error)

GET/v1/accounts/{account_id}/non-trade-activities

Results are paginated.

ParametersExpand Collapse

accountID int64

query V1AccountGetNonTradeActivitiesParams

PageSize param.Field[int64]Optional

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

formatint64

maximum500

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

ReturnsExpand Collapse

type V1AccountGetNonTradeActivitiesResponse struct{…}

Data NonTradeActivityList

ID string

ID for the activity, in UUID-v7 format.

formatuuid

AccountID string

Account ID

ActivitySubtype string

Subtype within its activity_type.

ActivityType ActivityType

Categorization for the activity.

One of the following:

const ActivityTypeMoneyMovement ActivityType = "money_movement"

const ActivityTypeInterest ActivityType = "interest"

const ActivityTypeFee ActivityType = "fee"

const ActivityTypeDividend ActivityType = "dividend"

const ActivityTypeOptionEvent ActivityType = "option_event"

const ActivityTypeTransfer ActivityType = "transfer"

const ActivityTypeCorporateAction ActivityType = "corporate_action"

const ActivityTypeTaxWithholding ActivityType = "tax_withholding"

const ActivityTypeAdjustment ActivityType = "adjustment"

const ActivityTypeOther ActivityType = "other"

Amount string

Cash amount change.

CreatedAt Time

The creation time at UTC, when this activity became part of the ledger

formatdate-time

Currency string

Currency of the cash amount. Always USD for now.

EffectiveDate Time

Effective date for the activity

formatdate

InstrumentType SecurityType

The security type.

One of the following:

const SecurityTypeCommonStock SecurityType = "COMMON_STOCK"

const SecurityTypeIndex SecurityType = "INDEX"

const SecurityTypeOption SecurityType = "OPTION"

const SecurityTypeCash SecurityType = "CASH"

Memo string

Memo

Qty string

Quantity change in the instrument.

State ActivityState

State for this activity.

One of the following:

const ActivityStateSettled ActivityState = "settled"

const ActivityStateCancelled ActivityState = "cancelled"

CancelledReferenceID stringOptional

Reference ID for the record that is being cancelled. Present only on records where the activity state is ‘cancelled’. The contents of this fields points at the reference_id of the original record that is being cancelled by this record.

InstrumentID stringOptional

Instrument identifier. Omitted when the activity has no single resolvable instrument.

formatuuid

ReferenceID stringOptional

Reference ID for the activity, in ULID format. Present only on records where activity state is ‘settled’. When a activity is cancelled, the cancelation record is pointing at this reference_id.

Symbol stringOptional

Symbol of the instrument. Omitted when the activity has no single resolvable instrument.

List non-trade activities

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.Accounts.GetNonTradeActivities(
    context.TODO(),
    0,
    clearstreet.V1AccountGetNonTradeActivitiesParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}

{
  "data": [
    {
      "account_id": "123456789",
      "activity_subtype": "cash_dividend",
      "activity_type": "dividend",
      "amount": "42",
      "created_at": "2026-09-11T20:52:01.412732Z",
      "currency": "USD",
      "effective_date": "2026-09-11",
      "id": "01a0923d-d704-78b2-8e38-5a1cbfb7d989",
      "instrument_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
      "instrument_type": "COMMON_STOCK",
      "memo": "test memo",
      "qty": "0",
      "reference_id": "01a0923d-d704-78b2-8e38-5a58c53f0cfa",
      "state": "settled",
      "symbol": "AAPL"
    }
  ],
  "metadata": {
    "request_id": "1a2b3c4d-5e6f-7890-1234-5a6b7c8d9e0f"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "67e95eb4-93b9-4010-8c9b-7ada7c2be93f"
  }
}

Returns Examples

{
  "data": [
    {
      "account_id": "123456789",
      "activity_subtype": "cash_dividend",
      "activity_type": "dividend",
      "amount": "42",
      "created_at": "2026-09-11T20:52:01.412732Z",
      "currency": "USD",
      "effective_date": "2026-09-11",
      "id": "01a0923d-d704-78b2-8e38-5a1cbfb7d989",
      "instrument_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
      "instrument_type": "COMMON_STOCK",
      "memo": "test memo",
      "qty": "0",
      "reference_id": "01a0923d-d704-78b2-8e38-5a58c53f0cfa",
      "state": "settled",
      "symbol": "AAPL"
    }
  ],
  "metadata": {
    "request_id": "1a2b3c4d-5e6f-7890-1234-5a6b7c8d9e0f"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

{
  "error": {
    "code": 404,
    "message": "Some requested entity was not found"
  },
  "metadata": {
    "request_id": "67e95eb4-93b9-4010-8c9b-7ada7c2be93f"
  }
}