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.
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. 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 based on an open source tagging system 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 usable topics, even non-financial ones, may be included here.
The above tag is semantically generated based on an open source tagging system we utilize and includes a variety of parameters. See below for a list of possible parameters, based on the International Press Telecommunications(IPTC) news taxonomy. Not every article will include these tags.
These are editorial tag(s) we sometimes add to identify a specific financial category or topic. They are specific, finite and defined by our editorial team based on their usefulness. Not every article will include these tags.
Some of these categories are based upon Morningstar sector designations. The complete list of category tag parameters is as follows:
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 an article Image, 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.