Overview

The Acuris Research Ideas API offers live access to stock insight events created by a network of independent research providers.

It is delivered over HTTPs, conforms to RESTful principles, and returns JSON objects.

Quick start

In order to retrieve ideas you must first request an API key token:

curl -XPOST -d 'username=YOUR_USERNAME' -d 'password=YOUR_PASSWORD' https://ideasequities.timgroup.com/api/v1/auth

You can then call the Research Ideas API endpoint and get the latest published content for your subscription, for example the first 10 events:

curl -H 'Authorization: Bearer YOUR_API_TOKEN' https://ideasequities.timgroup.com/api/v1/stream/smartkarma_tradeable/-1/10

Insights are represented as an ordered sequence of events (e.g. Publish, Cancel) with a correlation identifier. To construct the current state of an Insight all of its events must be processed in the provided order.

Compression

We recommend the use of GZIP compression to gain up to 80% reduction in the JSON data transfer.

Accept-Encoding:deflate,gzip

Concurrency and rate limits

The system does not enforce any concurrency or rate limits; however client systems should be written to use the Long Polling feature of the API. Long Polling blocks your request until a new event appears or a specified timeout expires. Long Polling provides lower latency and resource usage than repeatedly querying the API in a tight loop.