Margin

The API endpoint will list all margin information of an account

Results Explained

Attribute

Type

Description

margin

object

Object of margin calculations

margin.marginRequirement

number

Options:

  • 0.5 (2:1 leverage)
  • 1 (1:1 leverage)

margin.longMarketValue

number

Long market value - real-time $ value of current holdings

margin.debitBalance

number

Real-time $ value of debt; positive $ is a debit balance, negative $ is a credit balance

margin.equity

number

Real-time $ value of equity; calculated as longMarketValuedebitBalance

margin.equityFraction

number

Equity as a fraction of long market value; calculated as equity ÷ longMarketValue

margin.equityRequired

number

Minimum equity required to stay above a HOUSE margin call. If the account is in a margin call (HOUSE or EXCHANGE) this field will not appear here, but instead appear in the marginCall object

margin.restricted

boolean

Account becomes restricted (set to true) if equity is less than 50% of long market value (this is essentially a warning, at 35% the account will be in HOUSE margin call)

margin.daySMA

number

Current SMA using traditional calculations – Start with beginning of day SMA and update with deposits and withdrawals as well as stock buys and sells during the day. Deposits increase and withdrawals decrease SMA dollar for dollar. Buys increase and sells decrease SMA by 50% of trade $ value

margin.rtExcessEquity

number

Equity in excess of equityRequired calculated in real time (more is good)

margin.effectiveSMA

number

The lower of margin.daySMA and margin.rtExcessEquity. This is risk protection for the customer as well as DriveWealth. Using only margin.daySMA for lending on margin has the disadvantage that the SMA can become inflated if the market drops from start of day. If customers were to use their entire daySMA to buy stock on a day when the market drops, they are immediately placed into a HOUSE CALL. The margin.rtExcessEquity prevents that from happening by lending them only a (reduced) amount that would place them above a HOUSE margin call. That is the risk protection provided to both parties

margin.noBuyingPowerReason

string

Reason indicating why the user has no buying power:

  • MIN_MARGIN_EQUITY_NOT_MET - margin.equity is less than $2,000 and margin.debitBalance is greater than $0
  • EFFECTIVE_SMA_ZERO - SMA is $0
  • HOUSE_CALL - margin.equityfFaction is less than 35% (required house equity)
  • EXCHANGE_CALL - margin.equityfFaction is less than 25% (required exchange equity)
  • RESTING_ORDERS_WILL_TRIGGER_HOUSE_MARGIN_CALL - Market dropped after resting orders were placed, and will trigger house call if filled

margin.marginCall

object

Object of margin call calculations. Will only appear if noBuyingPowerReason is equal to MIN_MARGIN_EQUITY_NOT_MET or HOUSE_CALL or EXCHANGE_CALL

margin.marginCall.marginCallType

string

Options:

  • "EQUITY"
  • "HOUSE"
  • "EXCHANGE"

margin.marginCall.marginCallTriggerType

string

Options:

  • "ACCT_MAINT"

margin.marginCall.equityRequired

number

Minimum required equity to bring the account above a house margin call

margin.marginCall.callAmount

number

Minimum $ amount to be deposited in the account to bring the account above a house margin or equity call

margin. restingOrders

numbers

Total $ value committed in resting orders that reduces the effectiveSMA

📘

Additional Margin Information

Language
Authentication