AutoShares API
  • What is AutoShares?
  • API Documentation
    • Quick Start Guide
    • API Overview
    • Authentication
      • Authenticate with AutoShares SSO/Auth0
      • Triggering authentication with /login
      • For logout scenario
    • Onboarding Users
      • Account Setup
        • Syntax
        • Add Account To User
        • Add Account To User By Username
        • Get All Accounts Of A User
        • Get All Users Of An Account
        • Get Account Info
        • Update Alias Account For Current User
        • Remove Account From User
        • Get User's Trading Settings
        • Get User's Exchanges
      • Access Agreements
    • Account Balances and Buying Power
      • Get Balance Information For A User
      • Get Account's Balance Info
      • Get Historical Account Value
    • Order Processing and Trading
      • Place Order
        • Syntax
      • Verify Order Placement
        • Syntax
      • Verify Order Replacement
        • Syntax
      • Replace Order
        • Syntax
      • Cancel an Order
        • Syntax
      • Get Order's Info
        • Syntax
      • Get Filtered Orders
        • Syntax
      • Validate Order by ID
      • Positions
        • Get User's Positions
          • Syntax
        • Get User's Positions in a Security
          • Syntax
        • Get Market Value of all Security Groups
      • Managing Transactions
        • Get Transactions
          • Syntax
    • Streaming Data and Quotes
      • Streaming API Endpoints
        • Get Streamers' Info
        • Recover a Streamer Session
      • Quotes
      • Orders
      • Positions
      • Watchlists
      • Account Balances
      • User Balance
      • Securities
        • Get Equity Info by Internal ID
          • Syntax
        • Get Equity Info by Ticker
          • Syntax
        • Get Equity Info by Mask
          • Syntax
        • Get Filtered Equities
          • Syntax
        • Get Option Info by Internal ID
          • Syntax
        • Get Option Info by Ticker
          • Syntax
        • Get Options Expiration Dates
          • Syntax
        • Get an Option Chain
        • Get Filtered Options
          • Syntax
        • Get Company Logo By Symbol
    • Historical Chart Data
      • Get Comparison Chart Data
        • Syntax
      • Get Candles and Indicators for a Security
        • Syntax
      • Get Chart Data in the Excel Format
        • Syntax
    • Price Alerts
      • Create Price Alert
        • Syntax
      • Delete Price Alert
        • Syntax
      • Get Specific Alert
        • Syntax
      • Get User's Price Alerts
        • Syntax
      • Modify Price Alert
        • Syntax
    • Watchlists
      • Add Security to Watchlist by ID
        • Syntax
      • Add Security to Watchlist by Ticker
        • Syntax
      • Create New Watchlist
        • Syntax
      • Delete Watchlist
        • Syntax
      • Get Specific Watchlist
        • Syntax
      • Get User's Watchlists
        • Syntax
      • Remove Security From Watchlist by ID
        • Syntax
      • Remove Security from Watchlist by Ticker
        • Syntax
      • Rename Watchlist
        • Syntax
      • News
        • Get News for a Security
        • Get Corporate Actions for a Security
    • [Webhooks and SDKs]
    • Wires, ACH, and Account Transfers
      • ACH Setup
        • Create A New ACH Relationship
        • Get an ACH Relationship
        • Modify an ACH Relationship
      • Deposit / Withdraw Funds
        • Deposit / Withdraw Funds via ACH
      • Get a Transfer's Info
        • Get an ACH Transfer's Info
        • Get All Transfers
    • Terms and Definitions
      • Part I
      • Part II
      • Part III
Powered by GitBook
On this page
  • Introduction
  • Response
  • Common Mistakes
  1. API Documentation
  2. Watchlists
  3. News

Get News for a Security

Fetch all recent news for a specific security

Introduction

This GET endpoint enables you to fetch the list of all recent news for a specific security by providing its ticker symbol.

There are four required parameters that must be provided in the request:

  1. Authorization (header). This is the authorization token from the very first token request. The value of this header must have the following format: Bearer BQ898r9fefi (Bearer + 1 space + the token).

  2. API version (path). Unless necessary, leave it at "1.0".

  3. symbol (query). This is the ticker symbol of the security for which the news must be fetched.

Here's the final template for this API request:

GET apiURL/v1.0/news?symbol=AAPL

Response

In response to this API request, you'll receive a JSON file containing the list of the recent news for the specified security.

[
  {
    "Key": "AAPL",
    "Date": 1573732801,
    "Source": "AAPL",
    "Header": "Apple's new 16-inch MacBook pro, a Google checking account?",
    "Attachment": "https://www.yahoo.com/entertainment/apples-16-inch-macbook-pro-120001975.html?.tsrc=rss",
    "Content": "Today's major tech headlines include first impressions of Apple's new MacBook Pro, Google possibly offering checking accounts in 2020 and Disney Plus' big launch that included over 10 million sign-ups.",
    "NewsId": 0
  },
  {
    "Key": "AAPL",
    "Date": 1573729200,
    "Source": "AAPL",
    "Header": "Beware of Runs on Bond Funds",
    "Attachment": "https://finance.yahoo.com/m/fc7b20c5-b0b7-3d99-b897-061b961cabad/beware-of-runs-on-bond-funds.html?.tsrc=rss",
    "Content": "In a less favorable market, however, bond fund investors could get hurt—not so much by worsening fundamentals, but the funds’ difficulty to meet redemptions in an illiquid market.  As much as 50% of the assets in high-yield bond funds and 15% of assets of all fixed-income funds could be vulnerable to a liquidity shortfall in the event of heavy investor redemptions.  “There are more risks to open-end bond funds than people are willing to acknowledge,” says Mark Grant, chief global strategist B. Riley FBR.",
    "NewsId": 0
  },
  {
    "Key": "AAPL",
    "Date": 1573725660,
    "Source": "AAPL",
    "Header": "AbbVie Sold $30 Billion in Bonds, and Two More Numbers to Know",
    "Attachment": "https://finance.yahoo.com/m/0551125d-2be3-3dc0-bf9e-e75bb4ad69bc/abbvie-sold-%2430-billion-in.html?.tsrc=rss",
    "Content": "You may have heard that number cited recently as the value of an asteroid called 16 Psyche .  If humans ever manage to mine the asteroid, a flood of space-gold would completely crater the terrestrial market.  All that extra supply would cause today’s gold price to plummet.",
    "NewsId": 0
  }
]

where:

Parameter
Description

Key

This is the ticker symbol of the security for which the news were fetched.

Date

This is the date of the news article.

Source

This is the ticker symbol of the security for which the news were fetched.

Header

This is the header of the news article.

Attachment

This is the URL of the news.

Content

This is a preview of the news article.

NewsId

This is the ID of the news article.

Common Mistakes

Here are some of the common mistakes that developers make when attempting to retrieve the news for a specific security.

{
    "error": "Application key is not defined or does not exist"
}

Failing to Specify the Query Parameters

It's crucial to understand that the security parameter must be provided in the request; otherwise you'll receive the 404 status code.

PreviousNewsNextGet Corporate Actions for a Security

Last updated 1 year ago