BDL Emerging Markets Sentiment API

Table of contents

How to query 

You can use the following query to get the latest content matching your API subscription: 

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

 

Where: 

{stream_id} is the identifier for a given stream. In this case, the stream_id is equity_signals_em_v3.

{event_number} is the last event number processed (-1 is the start). 

{batch_size} is the maximum number of events to return, capped at 1000. 

The server will return as many events as specified in the {batch_size} or as many as are available, whichever is smaller. When no events are returned the end of the stream has been reached. 

When no new events are available the server will hold the connection open until new events are available, for up to five minutes. This means events will be pushed to the client as soon as they become available in the system. The header ‘X-Long-Poll’ can be used to configure how long the server should hold the connection open awaiting new events. 

Given a stream with five events, numbered 0 to 4, the following would return immediately with event 4: 

curl -H 'Authorization: Bearer YOUR_API_KEY' -H 'X-Long-Poll: 10' https://ideasequities.timgroup.com/api/v1/stream/{stream_id}/3/5 

Given the same stream of five events, the below would return after 10 seconds or when the event with number 5 is published: 

curl -H 'Authorization: Bearer YOUR_API_KEY' -H 'X-Long-Poll: 10' https://ideasequities.timgroup.com/api/v1/stream/{stream_id}/4/5 

If the intent is to subscribe to the live stream, a new request should be made whenever the previous has completed. When there are no new events the same request is repeated. Otherwise the event number is updated to that of the last processed event. 

To get the latest event number the following will give you the most recent ten events: 

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

Response 

Emerging markets equity signals are generated for seven regions at 14:30 (Asia/Seoul) – one hour before the Korea stock exchange (Koscom) close time. The regions covered in emerging markets are: Asia (other), China, Emea India, Korea, Latin America EM, and Taiwan. 

Shortly after the generation time a single IndicatorGenerated event will be produced for each of the regions containing details of the Indicators for that region. 

The API went live on January 8, 2021. The indicator event history was generated on this date using as-at input data. Events after this date are generated live. 

The following is an example of an IndicatorsGenerated event this will normally contain indicators for many instruments but for brevity this event only includes one: 

{ 

      "event_number" : 4567 

      "event_type" : "IndicatorsGenerated", 

      "data" : { 

         "date" : "2020-11-25", 

          "region" : "China", 

         "instruments" : [ 

            { 

               "public_id" : "5ea132da07d54bf49ab13a629fb3d527", 

               "ric" : "9988.HK", 

               "idea_volume" : "high", 

               "org_name" : " Alibaba Group Holding Ltd", 

               "bloomberg_ticker" : "9988 HK", 

               "indicator" : 10, 

               "components" : { 

                  "earnings" : 0, 

                  "intercept" : 5.4e-07, 

                  "decay" : 4.1e-07, 

                  "is_open" : 0, 

                  "experts" : 0 

               }, 

               "org_id" : "100906681", 

               "figi" : " BBG00QV37ZP9" 

            } 

         ] 

      }, 

   }