Overview
Retrieves the current account balance and related details for a specified account.
Description
This API returns detailed balance information for a specified account for the current user. The information returned includes account type, option level, and details on up to four balances - account balance, margin account balance, day trade balance, and cash account balance.
URL
https://etws.etrade.com/accounts/rest/accountbalance/{accountId}
HTTP Method: GET
Request Parameters
Property Type Required? Description
accountId path required Numeric account ID
Sample Request
GET https://etws.etrade.com/accounts/rest/accountbalance/83405188
Response Properties
Property Type Description
accountId integer Numeric account ID
accountType string The account's margin level. Possible values are: CASH, MARGIN.
optionLevel string The option level of the account, i.e., what option-related actions are allowed. Possible values are:
• LEVEL_1 - Write covered calls.
• LEVEL_2 - Write covered calls, purchases.
• LEVEL_3 - Write covered calls, purchases, spreads, uncovered puts. (Margin or IRA account required for spreads; margin account required for uncovered puts.)
• LEVEL_4 - Write covered calls, purchases, spreads, uncovered puts, uncovered equity/index calls, and uncovered index puts. (Margin account required.)
accountBalance complex Container for basic brokerage account balances
cashAvailableForWithdrawal double The amount of cash that is available for withdrawal
cashCall double If a cash call has been issued, this value is the amount of cash or equivalent securities needed to meet the cash call. For a definition of cash call, refer to the E*TRADE online glossary.
fundsWithheldFromPurchasePower double The amount of any funds withheld from the purchasing power, if any
fundsWithheldFromWithdrawal double The total of any funds that are not allowed to be withdrawn
netAccountValue double The account value minus any margin debt
netCash double The net cash amount held in the account. A negative balance reflects margin debt.
sweepDepositAmount double The amount held in the sweep deposit account
totalLongValue double The total value of securities that are held long in the account
totalSecuritiesMktValue double The total value of the securities held in the account
totalCash double The total cash amount held in the account. A negative balance reflects margin debt.
marginAccountBalance complex Container for margin-related account balances. Only appears for margin-level accounts.
fedCall double If funds are required to meet a Regulation T fed call, this value is the amount the investor must deposit for buying on margin or selling short. For a definition of fed call, refer to the E*TRADE online glossary.
marginBalance double The net open balance in the user's margin account
marginBalanceWithdrawal double The amount of the margin balance that is available for withdrawal
marginEquity double The value of the account's margin positions minus any margin debt
marginEquityPct double The account's equity divided by the market value of its marginable securities
marginableSecurities double The value of marginable securities held in the account
maxAvailableForWithdrawal double The total amount of cash plus margin equity that is available for withdrawal from this account
minEquityCall double If the account's margin equity has fallen below E*TRADE's minimum account equity requirement, this value is the amount of additional equity required. For a definition of minimum equity call, refer to the E*TRADE online glossary.
nonMarginableSecuritiesAnd Options double The value of securities and options that are not marginable
totalShortValue double The total value of securities that are held short in the account
shortReserve double The amount reserved to cover the short positions in the account
dtBalance complex Container for account balances related to day-trading. Only appears for day-trading accounts.
dtCashBalance double The cash available for investment in a day-trading account
dtMarginBalance double The margin available for investment in a day-trading account
dtMarginableSecurities double The value of marginable securities held in a day-trading account
dtNonMarginableSecuritiesAndOptions double The value of non-marginable securities and options held in a day-trading account
dtStatus string The current status of a day-trading account. Possible values are:
• NOT_QUALIFIED
• QUALIFIED_4X
• MARGIN_CALL_2XD
• MARGIN_CALL_1XD
• MIN_EQUITY_CALL_1XK
• QUALIFIED_RESTRICTION
• CASH_ONLY
cashAccountBalance complex Container for account cash balances
cashAvailableForInvestment double The total amount of cash available for investment in the account
cashBalance double The amount of cash in the account
settledCashForInvestment double The amount of settled cash in the account
unSettledCashForInvestment double The amount of unsettled cash in the account
Sample Response - XML
<AccountBalanceResponse>
  <accountId>83405188</accountId>
  <accountType>MARGIN</accountType>
  <optionLevel>LEVEL_4</optionLevel>
  <accountBalance>
    <cashAvailableForWithdrawal>0.00</cashAvailableForWithdrawal>
    <cashCall>0.00</cashCall>
    <fundsWithheldFromPurchasePower>0.00</fundsWithheldFromPurchasePower>
    <fundsWithheldFromWithdrawal>0.00</fundsWithheldFromWithdrawal>
    <netAccountValue>-286.55</netAccountValue>
    <netCash>-286.55</netCash>
    <sweepDepositAmount>0.00</sweepDepositAmount>
    <totalLongValue>0.00</totalLongValue>
    <totalSecuritiesMktValue>0.00</totalSecuritiesMktValue>
    <totalCash>-286.55</totalCash>
  </accountBalance>
  <marginAccountBalance>
    <fedCall>0.00</fedCall>
    <marginBalance>-286.55</marginBalance>
    <marginBalanceWithdrawal>-286.55</marginBalanceWithdrawal>
    <marginEquity>-286.55</marginEquity>
    <marginEquityPct>0.00</marginEquityPct>
    <marginableSecurities>-1146.20</marginableSecurities>
    <maxAvailableForWithdrawal>-286.55</maxAvailableForWithdrawal>
    <minEquityCall>2286.55</minEquityCall>
    <nonMarginableSecuritiesAndOptions>-286.55</nonMarginableSecuritiesAndOptions>
    <totalShortValue>0.00</totalShortValue>
    <shortReserve>0.00</shortReserve>
  </marginAccountBalance>
</AccountBalanceResponse>
Sample Response - JSON
{
  "AccountBalanceResponse": {
    "accountId": "83405188",
    "accountType": "MARGIN",
    "optionLevel": "LEVEL_4",
    "accountBalance": {
      "cashAvailableForWithdrawal": "0.00",
      "cashCall": "0.00",
      "fundsWithheldFromPurchasePower": "0.00",
      "fundsWithheldFromWithdrawal": "0.00",
      "netAccountValue": "-286.55",
      "netCash": "-286.55",
      "sweepDepositAmount": "0.00",
      "totalLongValue": "0.00",
      "totalSecuritiesMktValue": "0.00",
      "totalCash": "-286.55"
    },
    "marginAccountBalance": {
      "fedCall": "0.00",
      "marginBalance": "-286.55",
      "marginBalanceWithdrawal": "-286.55",
      "marginEquity": "-286.55",
      "marginEquityPct": "0.00",
      "marginableSecurities": "-1146.20",
      "maxAvailableForWithdrawal": "-286.55",
      "minEquityCall": "2286.55",
      "nonMarginableSecuritiesAndOptions": "-286.55",
      "totalShortValue": "0.00",
      "shortReserve": "0.00"
    }
  }
}
Notes
  • Some of the properties in the response are complex - that is, they contain sub-properties. The properties marginAccountBalance, dtBalance, and cashAccountBalance all contain multiple sub-properties.
Sample use cases
Some possible use cases and workflows are described below.
Purpose Workflow Related APIs
list of accounts,
account detail
Display the type, description, and net value for each of the user's accounts as well as a detail display for each account, including balances and positions. List Accounts,
Get Account Balance,
Get Account Positions
balance summary When previewing or validating an order before placing it, use Get Account Balance to check the account balances for sufficient funds. Get Account Balance,
List Orders,
Preview Equity Order,
Preview Option Order,
Preview Equity Order Change,
Preview Option Order Change
Sandbox Samples

The only parameter for this API is the account ID, which is required. The following shows a typical request and response in the sandbox environment.

Request
GET https://etwssandbox.etrade.com/accounts/sandbox/rest/accountbalance/83405188.json
Response
{
  "AccountBalanceResponse": {
    "accountId": "83405188",
    "accountType": "MARGIN",
    "optionLevel": "LEVEL_4",
    "accountBalance": {
      "cashAvailableForWithdrawal": "9986621.36",
      "fundsWithheldFromWithdrawal": "0.00",
      "netAccountValue": "10086354.52",
      "netCash": "9997973.185855",
      "sweepDepositAmount": "0.00",
      "totalLongValue": "88255.00",
      "totalSecuritiesMktValue": "88255.00"
    },
    "marginAccountBalance": {
      "marginBalance": "9997973.19",
      "marginBalanceWithdrawal": "9986621.36",
      "marginEquity": "9989687.81",
      "marginableSecurities": "19978072.55",
      "maxAvailableForWithdrawal": "9986621.36",
      "nonMarginableSecuritiesAndOptions": "9986621.36",
      "shortReserve": "126.33"
    }
  }
}
Related APIs
PLEASE READ THE IMPORTANT DISCLOSURES BELOW

By using E*TRADE API ("API") and accepting the terms of the Application Programming Interface License Agreement and the Application Programming Interface User Agreement, you agree that API may employ security policies, procedures and systems of Third Party providers which may or may not be less stringent and secure than the policies, procedures and systems of E*TRADE Securities LLC ("E*TRADE") or its affiliates. Material provided on API may have been produced by independent third parties not affiliated or endorsed by E*TRADE or its affiliates ("Third Party"). To the extent that API or Third Party providers express opinions or make recommendations, you understand that such opinions or recommendations are expressed by the Third Party provider and are not the opinions or recommendations of E*TRADE or its affiliates. E*TRADE is not responsible for the accuracy of market data displayed on API or made available by Third Party providers. There may be latency between the time an order (or other information) is submitted from API and the time the order is received by E*TRADE. The E*TRADE Two Second Execution Guarantee or any similar guarantee does not apply for orders placed through API and Third Party provider web sites. The E*TRADE CompleteTM Protection Guarantee does not apply. Orders created and submitted through API are not vetted until they are received by E*TRADE. It is possible that E*TRADE may reject an order placed through API. Please see the Application Programming Interface License Agreement and the Application Programming Interface User Agreement for more information.


The E*TRADE family of companies provides financial services including trading, investing, and related banking products and services to retail investors.


Securities products and services offered by E*TRADE Securities LLC, Member FINRA/SIPC.


System response and account access times may vary due to a variety of factors, including trading volumes, market conditions, system performance, and other factors.