Anonymous Trade Ideas API

Table of contents

Overview

The Acuris Anonymous Trade Ideas API offers live push of idea open and close event messages from a fixed set of contributors in Asia, EMEA, North America.

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

Quick start

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 Anonymous Trade Ideas 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, 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. 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, hence providing lower latency and resource usage than repeatedly querying the API in a tight loop.