Account Activities

The account activities API provides access to a historical record of transaction activities that have impacted your account. Trade execution activities and non-trade activities, such as dividend payments, are both reported through this endpoint. See the bottom of this page for a full list of the types of activities that may be reported.

Paging of Results

Pagination is handled using the page_token and page_size parameters. page_token represents the ID of the end of your current page of results. If specified with a direction of desc, for example, the results will end before the activity with the specified ID. If specified with a direction of asc, results will begin with the activity immediately after the one specified. page_size is the maximum number of entries to return in the response. If date is not specified, the default and maximum value is 100. If date is specified, the default behavior is to return all results, and there is no maximum page size.

[GET] Get account activities of one type

GET/v2/account/activities/{activity_type}
Returns account activity entries for a specific type of activity.

Parameters

Path Parameters

activity_type
string
The activity type you want to view entries for. A list of valid activity types can be found at the bottom of this page.

Query Parameters

date
string<timestamp>
The date for which you want to see activities.
until
string<timestamp>
The response will contain only activities submitted before this date. (Cannot be used with date.)
after
string<timestamp>
The response will contain only activities submitted after this date. (Cannot be used with date.)
direction
string
asc or desc (default desc if unspecified.)
page_size
int
The maximum number of entries to return in the response. (See the section on paging above.)
page_token
string
The ID of the end of your current page of results. (See the section on paging above.)

Response

Array of TradeActivity or NonTradeActivity objects

[GET] Get account activities of multiple types

GET/v2/account/activities
Returns account activity entries for many types of activities. Body parameters are the same as the above endpoint, with one addition (listed below.)

Parameters

Query Parameters

activity_types
string
A comma-separated list of the activity types to include in the response. If unspecified, activities of all types will be returned.

Response

Array of TradeActivity and NonTradeActivity objects

TradeActivity Entity

Example

{
  "activity_type": "FILL",
  "cum_qty": "1",
  "id": "20190524113406977::8efc7b9a-8b2b-4000-9955-d36e7db0df74",
  "leaves_qty": "0",
  "price": "1.63",
  "qty": "1",
  "side": "buy",
  "symbol": "LPCN",
  "transaction_time": "2019-05-24T15:34:06.977Z",
  "order_id": "904837e3-3b76-47ec-b432-046db621571b",
  "type": "fill"
}
Copy

Properties

activity_type
string
FILL
id
string
An id for the activity. Always in “::” format. Can be sent as page_token in requests to facilitate the paging of results.
cum_qty
string<number>
The cumulative quantity of shares involved in the execution.
leaves_qty
string<number>
For partially_filled orders, the quantity of shares that are left to be filled.
price
string<number>
The per-share price that the trade was executed at.
qty
string<number>
The number of shares involved in the trade execution.
side
string
buy or sell
symbol
string
The symbol of the security being traded.
transaction_time
string<timestamp>
The time at which the execution occurred.
order_id
string<uuid>
The id for the order that filled.
type
string
fill or partial_fill

NonTradeActivity Entity

Example

{
  "activity_type": "DIV",
  "id": "20190801011955195::5f596936-6f23-4cef-bdf1-3806aae57dbf",
  "date": "2019-08-01",
  "net_amount": "1.02",
  "symbol": "T",
  "qty": "2",
  "per_share_amount": "0.51"
}
Copy

Properties

activity_type
string
See below for a list of possible values.
id
string
An ID for the activity, always in “::” format. Can be sent as page_token in requests to facilitate the paging of results.
date
string<timestamp>
The date on which the activity occurred or on which the transaction associated with the activity settled.
net_amount
string<number>
The net amount of money (positive or negative) associated with the activity.
symbol
string
The symbol of the security involved with the activity. Not present for all activity types.
qty
string<number>
For dividend activities, the number of shares that contributed to the payment. Not present for other activity types.
per_share_amount
string<number>
For dividend activities, the average amount paid per share. Not present for other activity types.

Activity Types

  • FILL: Order fills (both partial and full fills)
  • TRANS: Cash transactions (both CSD and CSW)
  • MISC: Miscellaneous or rarely used activity types (All types except those in TRANS, DIV, or FILL)
  • ACATC: ACATS IN/OUT (Cash)
  • ACATS: ACATS IN/OUT (Securities)
  • CSD: Cash deposit(+)
  • CSW: Cash withdrawal(-)
  • DIV: Dividends
  • DIVCGL: Dividend (capital gain long term)
  • DIVCGS: Dividend (capital gain short term)
  • DIVFEE: Dividend fee
  • DIVFT: Dividend adjusted (Foreign Tax Withheld)
  • DIVNRA: Dividend adjusted (NRA Withheld)
  • DIVROC: Dividend return of capital
  • DIVTW: Dividend adjusted (Tefra Withheld)
  • DIVTXEX: Dividend (tax exempt)
  • INT: Interest (credit/margin)
  • INTNRA: Interest adjusted (NRA Withheld)
  • INTTW: Interest adjusted (Tefra Withheld)
  • JNL: Journal entry
  • JNLC: Journal entry (cash)
  • JNLS: Journal entry (stock)
  • MA: Merger/Acquisition
  • NC: Name change
  • OPASN: Option assignment
  • OPEXP: Option expiration
  • OPXRC: Option exercise
  • PTC: Pass Thru Charge
  • PTR: Pass Thru Rebate
  • REORG: Reorg CA
  • SC: Symbol change
  • SSO: Stock spinoff
  • SSP: Stock split