Data Portal » API Data Feeds » BDL ETF Ideas API » Documentation

BDL ETF Ideas API

Table of contents

Table of contents

Documentation
Overview and quick start
Authentication and authorization
Example usage
How to query
Error Handling

Overview 

The Acuris ETF Ideas API gives you live push of ETF idea open and close event messages from contributors in all regions. 

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 ETF Ideas 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 usagpoe than repeatedly querying the API in a tight loop.