• Invest: 1-855-880-2559
  • Open 24/7

Ally Invest API

market/quotes{.format}

This call is deprecated -- please use market/ext/quotes


HTTP Request: GET

Description

This call will allow you to obtain quotes for a particular symbol, list of symbols, or watchlist ID. You can request real-time or delayed quotes depending on the access level of your account.

Common Stock Quote

  • Authentication Required: Yes
  • URI Parameters:
  • Header Parameters: None
  • Query Parameters (at least one):
    • symbols - a symbol, or comma-delimited list of symbols
    • watchlist - a watchlist id (this parameter takes precedence over any symbols listed)
    • delayed - true/false depending on whether to receive real-time quotes
  • Form Parameters: None

Option Quote

  • Authentication Required: Yes
  • URI Parameters:
  • Header Parameters: None
  • Query Parameters (all required):
    • underlying - underlying symbol for an option chain
    • expiration - expiration date in the format YYYY-MM-DD
    • type - type of option, Values:
      • CALL
      • PUT
    • strike - strike price of the chain
  • Form Parameters: None

Request Example (Stock)

GET /v1/market/quotes.xml?symbols=AAPL&delayed=false 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: api.tradeking.com

Request Example (Option)

GET /v1/market/quotes.xml?underlying=AAPL&expiration=2011-06-24&type=CALL&strike=285.0&delayed=true 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: api.tradeking.com

Response Example (Stock)

<?xml version="1.0" encoding="UTF-8"?>
<response id="77cf30da:12df25c7074:-7de4">
  <quotes>
    <instrumentquote>
      <greeks/>
      <instrument>
        <desc>APPLE INC</desc>
        <exch>NSD</exch>
        <sectyp>CS</sectyp>
        <sym>AAPL</sym>
      </instrument>
      <quote>
        <askprice>346.66</askprice>
        <bidprice>346.65</bidprice>
        <change>3.22</change>
        <extendedquote>
          <asksize>1</asksize>
          <bidsize>1</bidsize>
          <dividenddata>
            <amt>0.0</amt>
            <exdate>2005-05-11T00:00:00-04:00</exdate>
            <yield>4.9E-324</yield>
          </dividenddata>
          <earningspershare>17.91</earningspershare>
          <high52price>348.6</high52price>
          <highprice>346.69</highprice>
          <low52price>190.25</low52price>
          <lowprice>343.51</lowprice>
          <openprice>343.64</openprice>
          <prevclose>343.44</prevclose>
          <priceearningsratio>19.36</priceearningsratio>
          <sessionvolume>9190521</sessionvolume>
          <volume>9440588</volume>
        </extendedquote>
        <lastprice>346.66</lastprice>
        <pctchange>0.94</pctchange>
      </quote>
      <unknownsymbol>false</unknownsymbol>
    </instrumentquote>
  </quotes>
</response>

Response Example (Option)

<response id="3d6644c0:130af713b78:-2c4">
  <quotes>
    <instrumentquote>
      <greeks>
        <delta>0.999996</delta>
      </greeks>
      <instrument>
        <desc>AAPL Jun 24 2011 285.00 Call</desc>
        <exch>CMP</exch>
        <matdt>2011-06-24T00:00:00-04:00</matdt>
        <putcall>1</putcall>
        <sectyp>OPT</sectyp>
        <strkpx>285.0</strkpx>
        <sym>AAPL</sym>
      </instrument>
      <quote>
        <askprice>30.7</askprice>
        <bidprice>30.3</bidprice>
        <change>-4.0</change>
        <extendedquote>
          <asksize>21</asksize>
          <bidsize>21</bidsize>
          <contracthigh>38.9</contracthigh>
          <contractlow>31.75</contractlow>
          <contractsize>100</contractsize>
          <delta>0.999996</delta>
          <highprice>31.75</highprice>
          <lowprice>31.75</lowprice>
          <openprice>31.75</openprice>
          <prevclose>35.75</prevclose>
          <volume>5</volume>
        </extendedquote>
        <lastprice>31.75</lastprice>
        <pctchange>-11.19</pctchange>
      </quote>
      <underlying>
        <desc>APPLE INC</desc>
        <exch>NSD</exch>
        <sym>AAPL</sym>
      </underlying>
      <undlyquote>
        <askprice>319.0</askprice>
        <bidprice>315.5</bidprice>
        <change>-4.94</change>
        <extendedquote>
          <asksize>0</asksize>
          <bidsize>0</bidsize>
          <dividenddata>
            <amt>0.0</amt>
            <exdate>2005-05-11T00:00:00-04:00</exdate>
            <yield>4.9E-324</yield>
          </dividenddata>
          <earningspershare>20.98</earningspershare>
          <high52price>364.9</high52price>
          <highprice>317.7</highprice>
          <low52price>235.56</low52price>
          <lowprice>310.5</lowprice>
          <openprice>317.355</openprice>
          <prevclose>320.26</prevclose>
          <priceearningsratio>15.03</priceearningsratio>
          <sessionvolume>22544928</sessionvolume>
          <volume>22880182</volume>
        </extendedquote>
        <lastprice>315.32</lastprice>
        <pctchange>-1.54</pctchange>
      </undlyquote>
      <unknownsymbol>false</unknownsymbol>
    </instrumentquote>
  </quotes>
</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 (PDF) before you begin trading options. Options investors may lose the entire amount of their investment in a relatively short period of time.