Ally Invest API Documentation
Build your application to connect to our investment platform and the 250,000 traders connected to it.
GET accounts/:id/holdings{.format}
Description
This call will return detail information about the holdings for an account specified in the URI.
| Authentication Required | |
| Yes | OAuth 1.0a |
| URI Parameters | |
| id | a valid account number |
| format | a response format, default is xml (See Response Structure ) |
| Example URL | |
| https://devapi.invest.ally.com/v1/accounts/12345678/holdings.xml | |
Data Fields
| Data Tag | Description |
|---|---|
| accounttype |
Holdings attribute for where asset as held, "1"= cash, "2"= margin long, "5"=margin short |
| assetclass |
Holding asset class type |
| cfi |
Put or call code(FIXML)(for option contracts) |
| change | Holding asset change for the day |
| costbasis |
Holding cost basis |
| cusip |
Instrument cusip |
| desc |
Instrument description |
| factor | Instrument factor |
| gainloss |
Holding gain/loss overall |
| lastprice |
Instrument last price |
| marketvalue |
Holding market value |
| marketvaluechange |
Holding market value change |
| matdt |
Instrument maturity date (FIXML)(for option contracts) |
| mmy | Instrument maturity year/month (FIXML)(for option contracts) |
| mult | Instrument multiplier(for option contracts) |
| price | Instrument price |
| purchaseprice |
Holding purchase price |
| putcall |
put or call(for option contracts) |
| qty | Holding quantity |
| sectyp |
Instrument security type (FIXML) |
| strkpx |
Instrument strike price (FIXML) |
| sym | Instrument underlying symbol (FIXML) |
| symbol |
Holding underlying symbol |
| totalsecurities |
Total account market value |
Request Example
GET /v1/accounts/123456878/holdings.xml HTTP/1.1
Authorization: OAuth
oauth_consumer_key="672e71387c0a126f4e13296ecfb2b7bc",
oauth_nonce="cfdb7f42de425d94fbc24c11a920c33e",
oauth_signature="Vfm148kAgBZ6azEHqds43aY2UsEg3D",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="1306871932",
oauth_token="819682555b63ab8bd90a4138138e7365",
oauth_version="1.0"
Connection: close
Host: devapi.invest.ally.com
Response Example
<?xml version="1.0" encoding="UTF-8"?>
<response id="77cf30da:12df25c7074:-7e2f">
<accountholdings>
<holding>
<accounttype>2</accounttype>
<costbasis>40.9</costbasis>
<gainloss>16.47</gainloss>
<instrument>
<cusip>73935A104</cusip>
<desc>POWERSHARES QQQ NASDAQ 100</desc>
<factor>0.0</factor>
<sectyp>CS</sectyp>
<sym>QQQQ</sym>
</instrument>
<marketvalue>57.37</marketvalue>
<marketvaluechange>0.3125</marketvaluechange>
<price>57.37</price>
<purchaseprice>0.0</purchaseprice>
<qty>1.0</qty>
<quote>
<change>0.0</change>
<lastprice>57.37</lastprice>
</quote>
<underlying/>
</holding>
<holding>
<accounttype>1</accounttype>
<costbasis>950.09</costbasis>
<gainloss>-22.75999999999999</gainloss>
<instrument>
<cusip>594918AH7</cusip>
<desc>MICROSOFT CORP FIXED RT NT</desc>
<factor>0.0</factor>
<sectyp>BOND</sectyp>
<sym>M20AH7</sym>
</instrument>
<marketvalue>0.0</marketvalue>
<marketvaluechange>0.0</marketvaluechange>
<price>0.0</price>
<purchaseprice>0.9501</purchaseprice>
<qty>1.0</qty>
<quote>
<change>0.0</change>
<lastprice>0.0</lastprice>
</quote>
<underlying/>
</holding>
<totalsecurities>984.6999999999971</totalsecurities>
</accountholdings>
</response>
Disclaimer:
Any mention of actual symbols are to be used for coding purposes only and do not imply a recommendation or solicitation to buy or sell a particular security or to engage in any particular investment strategy.
At the time of publication and in the preceding month, Ally Invest did not have ownership greater than 1% in any stocks mentioned here and does not have any other actual, material conflict of interest known at the time of publication.
Ally Invest did not receive compensation from a public offering or from investment banking services related to any companies mentioned here within the past 12 months, or expects to receive any in the next 3 months. Ally Invest did not engage in market making in the securities mentioned here.
Ally Invest Securities' background can be found at FINRA's BrokerCheck . Options involve risk and are not suitable for all investors.
Review the Characteristics and Risks of Standardized Options brochure before you begin trading options. Options investors may lose the entire amount of their investment in a relatively short period of time.