Overview
Returns a list of E*TRADE accounts for the current user.
Description

This API returns a list of E*TRADE accounts for the current user. Only brokerage accounts are returned - that is, accounts that can be used for trading, as opposed to credit cards, etc.

URL
https://etws.etrade.com/accounts/rest/accountlist
HTTP Method: GET
Request Parameters

No parameters.

Response Properties
Property Type Description
accountDesc string A text description of the account
accountId integer Numeric account ID
marginLevel string The account's margin level. Possible values are: CASH, MARGIN.
netAccountValue double The total value of the account. This includes cash plus stocks, options, mutual funds, and bonds.
registrationType string The type of account. Possible values are: INDIVIDUAL, JOINT, CORPORATE, IRA, ESTATE, TRUST.
Sample Request
GET https://etws.etrade.com/accounts/rest/accountlist
Sample Response - XML
<AccountListResponse>
  <Account>
    <accountDesc>MyAccount-1</accountDesc>
    <accountId>83405188</accountId>
    <marginLevel>MARGIN</marginLevel>
    <netAccountValue>9999871.82</netAccountValue>
    <registrationType>INDIVIDUAL</registrationType>
  </Account>
  <Account>
    <accountDesc>MyAccount-3</accountDesc>
    <accountId>83405553</accountId>
    <marginLevel>CASH</marginLevel>
    <netAccountValue>100105468.99</netAccountValue>
    <registrationType>INDIVIDUAL</registrationType>
  </Account>
  <Account>
    <accountDesc>SIMPLE IRA</accountDesc>
    <accountId>83405188</accountId>
    <marginLevel>CASH</marginLevel>
    <netAccountValue>99794.13</netAccountValue>
    <registrationType>IRA</registrationType>
  </Account>
</AccountListResponse>

Sample response - JSON

{
  "AccountListResponse": {
    "Account": [
      {
        "accountDesc": "MyAccount-1",
        "accountId": "83405188",
        "marginLevel": "MARGIN",
        "netAccountValue": "9999871.82",
        "registrationType": "INDIVIDUAL"
      },
      {
        "accountDesc": "MyAccount-3",
        "accountId": "83405553",
        "marginLevel": "CASH",
        "netAccountValue": "100105468.99",
        "registrationType": "INDIVIDUAL"
      },
      {
        "accountDesc": "SIMPLE IRA",
        "accountId": "83405188",
        "marginLevel": "CASH",
        "netAccountValue": "99794.13",
        "registrationType": "IRA"
      }
    ]
  }
}
Sample use cases
Some possible use cases and workflows are described below.
Purpose Workflow Related APIs
List 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. List Accounts,
Get Account Balance,
Get Account Positions
Set the active account for a trade When setting up an order, allow the user to select an account; this is critical when a user has multiple accounts and wants to place an order in a specific account (e.g., IRA rather than day-trading account). List Accounts,
Get Account Balance
Retrieve account summary info for order lists, order previews, and order validation When listing orders, previewing an order, or validating an order before placing it, use List Accounts to look up the account type, description, and balance(s). Get Account Balance,
List Orders,
Preview Equity Order,
Preview Option Order,
Preview Equity Order Change,
Preview Option Order Change
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.