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.
news
article
tags
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.
symbols
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.
sectors
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:
Technologysubsectors
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:
Business_Finance
Disaster_Accident
Education
Entertainment_Culture
Environment
Health_Medical_Pharma
Hospitality_Recreation
Human_Interest
Labor
Law_Crime
Politics
Religion_Belief
Social_Issues
Sports
Technology_Internet
Weather
War_Conflict
Other
category_tag
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:
Technology
Energy
Financials
Materials
Utilities
Healthcare
Capital_Goods
Transportation
Telecom
Consumer_Goods
Consumer_Services
Media_Advertising
Business_Services
Precious_Metals
Forex
Financial_News An editorially chosen all-purpose financial headline category.
General When no topic is specified.
Green_Tech
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.
Necessary cookies are absolutely essential for the website to function properly. This category only includes cookies that ensures basic functionalities and security features of the website. These cookies do not store any personal information.
Any cookies that may not be particularly necessary for the website to function and is used specifically to collect user personal data via analytics, ads, other embedded contents are termed as non-necessary cookies. It is mandatory to procure user consent prior to running these cookies on your website.