Data Files

Using Data Feed Altruist Public API shares the following data files.

Demographics File

File Name: ALT_DEMO_YYYYMMDD.csv

Demographics File Fields
FieldFormatDefinition
As of DateYYYY-MM-DDDate of the record
Rep CodeUp to 20 characters - alphanumericAdvisor identifier
Display Rep CodeUp to 20 characters - alphanumericAdvisor identifier - to be displayed to advisor
Account NumberstringAltruist account number
Account Owner NamestringName of Account Owner
Account NamestringName of Account
Account TypestringType of Account

Account Type Possible Values

Account Type Possible Values
Altruist Account Type
SOLO 401K
TRADITIONAL BENEFICIARY IRA
INDIVIDUAL
ROTH BENEFICIARY IRA
TRUST
UTMA
SEP IRA
SIMPLE IRA
C CORPORATION
ROTH IRA
IRA
JOINT TENANT WROS
ROLLOVER IRA
UGMA
S CORPORATION

Positions File

File Name: ALT_POS_YYYYMMDD.csv

Positions File Fields
FieldFormatDefinition
As of DateYYYY-MM-DDDate of the record
Rep CodeUp to 20 characters - alphanumericAdvisor identifier
Display Rep CodeUp to 20 characters - alphanumericAdvisor identifier - to be displayed to advisor
Account NumberstringAltruist account number
CUSIPstringCUSIP identifier
Ticker SymbolstringTicker Symbol identifier
Security NamestringSecurity description
Security TypestringType of security in accordance to Altruist security master
Price4 decimal precisionEnd of day price for the security
Quantity6 decimal precisionTotal number of shares in the position
Market Value2 decimal precisionTotal value of position
Cost Basis2 decimal precisionTotal cost basis for the position

Security Type Possible Values

Security Type Possible Values
TYPE_NAME
WARRANT
ETF
UNIT
OPTION
TBILL
CP
INDEX
CASH
CD
EQUITY
FI
MUTUAL
MBS
OTHER

Transactions File

File Name: ALT_TRN_YYYYMMDD.csv

Transactions File Fields
FieldFormatDefinition
Account NumberstringAltruist account number
Detailed Transaction TypestringTransaction type that is more detailed.
Display Transaction TypestringTransaction type that is displayed on the Altruist platform
Transaction DateYYYY-MM-DDDate that transaction was initiated
Settle DateYYYY-MM-DDDate that transaction is finalized
Transaction DescriptionstringDescription of the transaction
CUSIPstringCUSIP identifier
SymbolstringSymbol
Quantity6 decimal precisionTotal number of shares in the position
Transaction Price4 decimal precisionPrice of the shares in the transaction
Amount2 decimal precisionTotal value of the transaction
As of DateYYYY-MM-DDDate of the record

Transaction Type Possible Values

Transaction Type Possible Values
Detailed Transaction TypeTransaction TypeDescriptionPosition EffectCash Effect
BTCbuyBuy to CloseIncreaseDecrease
BTObuyBuy to OpenIncreaseDecrease
BUYbuyBuyIncreaseDecrease
COVERbuyCovering a ShortIncreaseDecrease
DEPdepositCash DepositIncrease
DIVIdividendDividend IncomingIncrease
DIVOdividendDividend OutgoingDecrease
EXPIpositionOption Expiration - ShortIncrease
EXPOpositionOption Expiration - LongDecrease
FEEIfeesFee IncomingIncrease
FEEOfeesFee OutgoingDecrease
IGNOREn/aIgnored Transaction (not presented to UI)
INTIinterestInterest IncomingIncrease
INTOinterestInterest OutgoingDecrease
JOURIjournalJournal IncomingIncrease
JOUROjournalJournal OutgoingDecrease
OTHWITHHOwithholdOTHER WITHHOLDING OUT (NO PERF IMPACT)Decrease
OTHWITHHIwithholdOTHER WITHHOLDING IN (NO PERF IMPACT)Increase
POSIpositionPosition IncomingIncrease
POSOpositionPosition OutgoingDecrease
PRINIprincipalPrincipal IncomingIncrease
PRINOprincipalPrincipal OutgoingDecrease
REDIVIdividend_reinvestmentReinvested Dividend InIncrease
REDIVOdividend_reinvestmentReinvested Dividend OutDecrease
SELLsaleSellDecreaseIncrease
SHORTsaleShortDecrease
SPLITIsplitSplit IncomingIncrease
SPLITOsplitSplit OutgoingDecrease
STCsaleSell to CloseDecreaseIncrease
STOsaleSell to OpenDecreaseIncrease
UNKNOWNUnknownUnknown Transaction Type
WITHDwithdrawalCash WithdrawalDecrease
WITHHIwithholdWithholding IncomingIncrease
WITHHOwithholdWithholding OutgoingDecrease
XBUYtrade_canceled_buyCancel BuyDecreaseIncrease
XFERItransferSecurities Transfer IncomingIncrease
XFEROtransferSecurities Transfer OutgoingDecrease
XFERMItransferMoney Transfer Incoming (specific to intra-account money movement activity)
XFERMOtransferMoney Transfer Outgoing (specific to intra-account money movement activity)
XSELLtrade_canceled_sellCancel SellIncreaseDecrease

Cost Basis File

File Name: ALT_CB_YYYYMMDD.csv

Cost Basis File Fields
FieldFormatDefinition
Account NumberstringAltruist account number
Cost Basis IDUp to 28 digits - numericUnique ID for the Tax lot
As of DateYYYY-MM-DDDate of the record
Open DateYYYY-MM-DDDate the tax lot was created
CUSIPstringCUSIP identifier
SymbolstringTicker Symbol identifier
DescriptionstringSecurity description
Quantity6 decimal precisionTotal number of shares in the position
Cost Basis Unadjusted10 decimal precisionUnadjusted cost basis for the position
Cost Basis Adjusted10 decimal precision

What’s Next