The Alpha News Stream (ANS) requires an X-Api-Key HTTP header to be present with each call made to the API. Once you have signed up for your ANS developer account, you are given an ANS API Key, which must be present as a header in each API call you make.
Your ANS API consumption is tracked and, based on your plan, usage is billed accordingly. We require the API key to be passed using HTTP headers to ensure the security of your credentials in transit.
These are the optional input parameters that filter the output depending on which parameters you provide.
These are the objects you will get back with each call to the Alpha News Stream API, providing the schema you can use to integrate into your applications.
The schema can be used to generate integration code, and do most of the heavy lifting when decoding the response from the ANS API.
The list below shows objects we add to each news headline when available or applicable. Press releases will typically include fewer data points.
These are tag(s) we add, where possible, to identify company ticker symbols for the following exchanges: NYSE, NASDAQ, TSX, and the LSE’s FT100 stocks. The symbols field that you get back with each call to the API will include the exchange prefix in ISO 10383 format (XNYS, XNAS, XTSE and XLON, respectively). An example is: “XNYS:IBM”. Not every article will include these tags. (Symbol format in the output is EXCHANGE:TICKER whereas input parameter format is TICKER.EXCHANGE). Not every article will include a symbols tag.
These are tag(s) we add when a symbol tag is present based on the symbols above. It identifies the company’s industry sector as defined by the exchange. This is distinct from the category_tags; outlined below. Most, but not all, symbols-identified articles will include this tag. The most commonly used sector designations include:Technology
These are tag(s) we add, when a symbol tag is present based on the symbols, above. It identifies the company’s industry subsector as defined by the exchange. It includes many potential parameters for companies public or private, so there is no list of all possible parameters. Most, but not all, symbols-identified articles will include this tag.
companies Company names within an article may be listed here.
The above tag is semantically generated and includes many potential parameters for companies public or private, so there is no list of all possible parameters. Not every article will include these tags.
images Includes the link to an associated image within the RSS newsfeed.
The above data point adds a link, where available, to an image included in the RSS newsfeed content that appears in the originating article. Copyright applies.
paywall Designates whether the headline source has a paywall.
The above tag is generated to show whether the originating news source has a paywall for the linked article. Designations are: Hard (most or all access requires subscription or registration); Soft (articles are free to read until some article limit is reached, then subscription is required); or None (all articles are free to read)
topics Other topics, even non-financial, may be included here.
The topics tag may be found in some historical headlines. It was semantically generated based on an open source tagging add-on we no longer utilize and includes a variety of generic topics as parameters. This tag could be used to identify future data points. Topics may include:
These are editorial tag(s) we add to identify a specific financial category or topic. They are specific, finite and defined by our editorial team based on their usefulness. Some will overlap with sector tag parameters. Not every article will include these tags.
Some of these categories are based upon Morningstar sector designations. Category tag parameters may include:
Financial_News An editorially chosen all-purpose financial headline category.
General When no topic is specified.
Business_Video Just video.
Business_Podcast Just podcasts
Financial_Bloggers Just bloggers.
For your convenience, we have included Open API specifications:
Most plans have unlimited usage. Check your plan for specifics.
• Trial plan: 250 requests per day
• Custom plan: per agreement
• Burst rate limit: 1 request per second
• Editorial limit: In headlines where Summary text is available, we provide only the first 300 characters. This Summary text and the link to article images, if available, are for research use only as they are copyright-protected by the source.
• Editorial limit: Archived headlines are available back to January 1, 2017.
Streaming News (no older than 14 days): To avoid missing a headline, the best practice is to request all news, count=1000, once every 5 minutes. Once you have retrieved the headlines, you can sort or filter them as appropriate for your needs (by symbol, by source, by topic, etc.)
Archived News (any headline older than 14 days): The best practice is to request by symbol or source, count=100, with a start_date and end_date. If you are scanning a large date range, start with the most recent end_date and work backwards, adjusting the end_date to the earliest found article date, and repeat.