Trade Ideas API

Table of contents

Overview

The Acuris Trade Ideas API offers access to an exclusive dataset comprising 15 years of point-in-time history of equity trade recommendations from over 12,000 salespeople and research providers at hundreds of sell-side institutions ranging in size from global tier-one banks to 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 API endpoint and get the latest published content for your subscription, for example the first 10 events:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://ideasequities.timgroup.com/api/v1/stream/{stream_id}/-1/10

Ideas are represented as an ordered sequence of events (e.g. Open, Update, Close) with a correlation identifier. To construct the current state of an Idea 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.