Account Activities

The account activities API provides access to a historical record of transaction activities that have impacted your account.

The TradeActivity Object

Sample TradeActivity

{
  "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"
}

Properties

AttributeTypeDescription
activity_typestringFor trade activities, this will always be FILL
cum_qtystringThe cumulative quantity of shares involved in the execution.
idstringAn ID for the activity. Always in :: format. Can be sent as page_token in requests to facilitate the paging of results.
leaves_qtystringFor partially_filled orders, the quantity of shares that are left to be filled.
pricestringThe per-share price that the trade was executed at.
qtystringThe number of shares involved in the trade execution.
sidestringbuy or sell
symbolstringThe symbol of the security being traded.
transaction_timestringThe time at which the execution occurred.
order_idstringThe id for the order that filled.
typestringfill or partial_fill

The NonTradeActivity (NTA) Object

Sample NTA

{
  "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"
}

Properties

AttributeTypeDescription
activity_typestringSee below for a list of possible values.
idstringAn ID for the activity. Always in :: format. Can be sent as page_token in requests to facilitate the paging of results.
datestringThe date on which the activity occurred or on which the transaction associated with the activity settled.
net_amountstringThe net amount of money (positive or negative) associated with the activity.
symbolstringThe symbol of the security involved with the activity. Not present for all activity types.
qtystringFor dividend activities, the number of shares that contributed to the payment. Not present for other activity types.
per_share_amountstringFor dividend activities, the average amount paid per share. Not present for other activity types.

Pagination 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.

Activity Types

activity_typeDescription
FILLOrder fills (both partial and full fills)
TRANSCash transactions (both CSD and CSW)
MISCMiscellaneous or rarely used activity types (All types except those in TRANS, DIV, or FILL)
ACATCACATS IN/OUT (Cash)
ACATSACATS IN/OUT (Securities)
CFEECrypto fee
CSDCash deposit(+)
CSWCash withdrawal(-)
DIVDividends
DIVCGLDividend (capital gain long term)
DIVCGSDividend (capital gain short term)
DIVFEEDividend fee
DIVFTDividend adjusted (Foreign Tax Withheld)
DIVNRADividend adjusted (NRA Withheld)
DIVROCDividend return of capital
DIVTWDividend adjusted (Tefra Withheld)
DIVTXEXDividend (tax exempt)
FEEFee denominated in USD
INTInterest (credit/margin)
INTNRAInterest adjusted (NRA Withheld)
INTTWInterest adjusted (Tefra Withheld)
JNLJournal entry
JNLCJournal entry (cash)
JNLSJournal entry (stock)
MAMerger/Acquisition
NCName change
OPASNOption assignment
OPEXPOption expiration
OPXRCOption exercise
PTCPass Thru Charge
PTRPass Thru Rebate
REORGReorg CA
SCSymbol change
SSOStock spinoff
SSPStock split