How-tos

Getting Started with Accern API on Bluemix

Share this post:

Accern monitors over 300 million public news websites, blogs, SEC filings, and social media websites such as Twitter in real time to help institutional investors find relevant news stories across 8,000 U.S. public equities. The company provides quantitative traders with a low-latency API data feed solution and also serves fundamental investors, proprietary traders, equity researchers, and others with a web-based portal.

Here’s a list of the types of content and data sources that Accern monitors:

  • Data Sources – Acquires information from over 300 million online sources, that includes:
    • Public News Websites
    • Public Blogs
    • Press Releases
    • Social Media Sites, such as Twitter
    • Financial Documents, e.g., SEC Filings
  • Financial Assets Coverage – 8,000-plus U.S. public equities
  • Financial Events Coverage – 1,000-plus financial events
  • Financial Asset Mapping – Tickers, Bloomberg IDs
  • Number of Articles Processed Each Day – 5 Million News/Blogs and 160 million Tweets
  • Number of Articles Delivered Each Day – 20,000+
  • Format of Data Delivered – JSON, CSV

Adding the Accern API to your Bluemix Dashboard

First, you will need to create a Bluemix account, if you do not already have one.

To add Accern API to your Bluemix Dashboard, search for Accern in the Bluemix Catalog, and you’ll be presented with the service tile. Click on the service tile, and you’ll get the Catalog Service Details page, as shown below.

Screen shot of Accern tile in the Bluemix catalog

Getting your API Access Token

To activate your Accern API on Bluemix, you will need an API access token. To get an API access token, you will need to create an account. Follow the steps below to request the API access token.

Step 1: Creating an account on Accern

Go to https://app.accern.com and create an account. If you already have an account, you can login directly to the platform.Screen shot of the Accern login web page

 

Step 2: Requesting your API access token

Once you have successfully logged in, you can click on the menu option at the top-right corner. Then, click on the API Tokens option, as shown below.Accern API token

 

Next, choose the number of Access tokens you need and submit your request, as shown below.Accern Request API tokens sreen shot

 

Once you have requested the token, our team will review your request and the token(s) will be sent to your registered email address.

Accessing Accern API

You are now ready to access the Accern API using your authentication token. To authenticate your API call, provide your access token as shown below:

http://feed.accern.com/v3/alphas?token=TOKEN

 Make sure to replace TOKEN above with your token. Let us say your token is abcdxyz1234, then your request will look like this:

http://feed.accern.com/v3/alphas?token=abcdxyz1234

This API call will return the100 most recent documents in JSON format. If you want to receive data in a flattened CSV format, your API call will change to the one below:

http://feed.accern.com/v3/alphas.csv?token=abcdxyz1234

Notice the .csv part in the url.

Passing Filter Parameters in the API Call

Accern API supports several filter parameters to segment the data to suit your needs. These parameters are last_id, index, and ticker.

  • last_id: Returns the next 100 documents that came after the provided last_id. You can use last_id to prevent duplicates while keeping in sync with the API, especially while streaming in real-time. Here’s an example request:
    http://feed.accern.com/v3/alphas?last_id=1774184&token=TOKEN

    This will fetch the next 100 documents that came after last_id = 1774184.

  • index: Filters documents by the index, see the table below for supported indexes. To filter by multiple indexes, pass a comma-separated list of index strings. Below are the list of supported indexes and their corresponding index string values.

 

 

Index Expected index string value
S&P 500 sp500
Russell 1000 russell1000
Russell 3000 russell3000
Wilshire 5000 wilshire5000
Barron’s 400 barrons400
DOW 30 dow30

 

 

When filtering by index, your API request will change as shown in the example below:

http://feed.accern.com/v3/alphas?index=sp500&token=TOKEN

This request will fetch the 100 most recent documents that belong to any company in the S&P 500 index.

To receive documents from multiple indexes, you can pass comma-separated index string values. See the example below that illustrates this use case:

http://feed.accern.com/v3/alphas?index=sp500,dow30&token=TOKEN

This request will fetch the 100 most recent documents that belong to any company in the S&P 500 or Dow 30 indexes.

  • ticker: Filters documents by ticker. To filter by multiple tickers pass a comma-separated list of tickers. Currently, the API supports only the U.S. public equities and their corresponding tickers. Here’s an example request:
    http://feed.accern.com/v3/alphas?ticker=amzn&token=TOKEN

    This request will fetch the 100 most recent documents that mention Amazon.com, Inc. (AMZN)

    If you want to track multiple companies, you can pass a comma-separated list of tickers, as in the example request below:

    http://feed.accern.com/v3/alphas?ticker=amzn,aapl&token=TOKEN

    This request will fetch the 100 most recent documents that mention Amazon.com, Inc. (AMZN) or Apple Corporation (AAPL).

Additional Information

So far, we have summarized the basic usage of the Accern API. For more advanced topics, please follow the links provided below.

If you need any technical support, like historical data access or backtest reports, feel free to drop us a note at support@accern.com. Or, you can post a comment on this blog article. Our team will get back to you as soon as possible.

More How-tos stories
May 1, 2019

Two Tutorials: Plan, Create, and Update Deployment Environments with Terraform

Multiple environments are pretty common in a project when building a solution. They support the different phases of the development cycle and the slight differences between the environments, like capacity, networking, credentials, and log verbosity. These two tutorials will show you how to manage the environments with Terraform.

Continue reading

April 29, 2019

Transforming Customer Experiences with AI Services (Part 1)

This is an experience from a recent customer engagement on transcribing customer conversations using IBM Watson AI services.

Continue reading

April 26, 2019

Analyze Logs and Monitor the Health of a Kubernetes Application with LogDNA and Sysdig

This post is an excerpt from a tutorial that shows how the IBM Log Analysis with LogDNA service can be used to configure and access logs of a Kubernetes application that is deployed on IBM Cloud.

Continue reading