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

Ally Invest API

GET/POST market/news/search{.format}

Description

This call will return a listing of news headlines based on the current keyword and/or symbol search.

Authentication Required
Yes OAuth 1.0a
Query Parameters
symbols a comma delimited list of symbols to search on
maxhits number of results to return (default: 10)
startdate search for articles between this date and enddate (enddate parameter is required)
enddate search for articles between start date and this date (enddate parameter is required)
Example URL
https://api.tradeking.com/v1/market/news/search.xml

Data Fields

Data Tag Description
id article id used for article retrieval
headline the title of the article
date date and time the article was published

Special Considerations

News is only returned for a total of 180 days from the time of request.

Request Example

GET /v1/market/news/search.xml?symbols=aapl&maxhits=3 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

  <?xml version="1.0" encoding="UTF-8"?>
  <response id="7b80be33:136982a9fda:-5598">
    <articles>
      <article>
        <date>04/09 13:53</date>
        <headline>Cost of ebooks could tumble after probe</headline>
        <id>cf76baf72f02365108d85d11ec070eb5</id>
        <story/>
      </article>
      <article>
        <date>04/09 13:47</date>
        <headline>Library going high-tech</headline>
        <id>4cafc023bbe006a192cb9ca56ede2f11</id>
        <story/>
      </article>
      <article>
        <date>04/09 13:37</date>
        <headline>Chinese Teenager Sells Kidney To Buy iPad, iPhone</headline>
        <id>a5cd885ab0515db7048ec950d587a8fc</id>
        <story/>
      </article>
    </articles>
  </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.