Você está na página 1de 7

EIKON DATA & DSWS – API

EIKON DATA API EM 4 PASSOS:


1. Executar o Thomson Reuters Eikon
O Thomson Reuters Eikon atua como um Proxy que possibilita a interface entre a biblioteca Python e R Eikon Data
APIs e a plataforma Eikon. Por esse motivo, o Eikon deve estar em execução quando você utiliza a biblioteca Python
Eikon Data APIs. Quando iniciado, o Eikon começa a escutar as conexões locais websocket na porta 9000 ou a
próxima porta disponível se a porta 9000 já estiver ocupada. Você precisa ter uma conta de usuário Eikon válida para
poder iniciar o Eikon.

2. Criar uma chave de autenticação (App Key) para sua aplicação


Cada aplicação que utiliza o Eikon Data APIs deve ser identificada por uma chave de autenticação chamada
Application Key ou App Key. Essa chave, que é exclusiva para cada aplicativo, deve ser criada usando o App Key
Generator que pode ser encontrado no App Library ou através da barra de busca do TR Eikon Desktop. Veja abaixo
como executá-lo e criar uma chave de autenticação para um novo aplicativo:

2.1. No campo de pesquisa do Eikon digitar "App Key" e executar o App Key Generator:

2.2. No App Key Generator indicar um nome para o novo aplicativo, a API a ser utilizada e clicar em “Register
New App”.

2.3. Ler os Termos e Condições e clicar em "Accept".

2.4. Copiar a chave gerada (App Key) para utilizá-la posteriormente no seu aplicativo.

Autores: Paulo Leite e Pedro Alexandre


3. Instalar a biblioteca Python & R para Eikon Data APIs
A biblioteca Python e R para Eikon Data APIs é uma biblioteca de fácil uso, possibilitando o acesso aos dados
provenientes da base de dados do Eikon de forma estruturada. A apresentação dos dados da biblioteca Python para
o Eikon Data APIs está disponível como Dataframe Pandas ou como objetos JSON.
Execute o seguinte comando para instalar o pacote Eikon a partir do Python Package Index (PyPI):

pip install eikon

Obs.: Esse comando deve ser executado no prompt (CMD). Se a pasta "Script /" da sua instalação do Python não
estiver incluída na variável de ambiente PATH, você pode até precisar navegar até essa pasta antes de executar o
comando pip.
Execute o seguinte comando para instalar o pacote Eikon para R:

install.packages("devtools")
library(devtools)
install_github("ahmedmohamedali/eikonapir")
library(eikonapir)

4. Let’s have some FUN!


Abrir o IDE do Python ou do R e tentar os seguintes comandos.
Inicialize o objeto Eikon. Substitua '8e5a3xxxxxxxxxxxxxxxxxxxxxxxxxxxx21b031c' com o chave gerada no passo 2.
Exemplo 1: Os comandos no exemplo a seguir retornarão o Faturamento e Lucro Bruto do Google, Microsoft e
Facebook:

#python #R
import eikon as ek library(eikonapir)
ek.set_app_key('8e5a3xxxxxxxxxxx set_app_id('8e5a3xxxxxxxxxxxxxxx
xxxxxxxxxxxxxxxxx21b031c')
xxxxxxxxxxxxx21b031c ')
df, err = ek.get_data(['GOOG.O','MSFT.O', 'FB.O'], df =get_data(as.list ('GOOG.O','MSFT.O', 'FB.O'),
[ 'TR.Revenue','TR.GrossProfit'] list ( 'TR.Revenue','TR.GrossProfit'),debug = FALSE)
)
df
df

Abaixo a saída dos comandos:


Instrument Revenue Gross Profit
0 GOOG.O 90272000000 55134000000
1 MSFT.O 85320000000 52540000000
2 FB.O 27638000000 23849000000
Exemplo 2: Os comandos a seguir retorna uma serie temporal dos preços diários das ações ordinárias da Microsoft
no período entre 4 de Janeiro e 6 de Janeiro de 2016.

#Python #R
df = ek.get_timeseries(["MSFT.O"],
df =get_timeseries (as.list ('MSFT.O'),
start_date="2016-01-04",
"2016-01-04T00:00:00",
end_date="2016-01-06")
"2016-01-06T00:00:00",
df
debug = FALSE)
df

Abaixo a saída dos comandos:


MSFT.O HIGH CLOSE LOW OPEN COUNT VOLUME
Date
2016-01-04 54.8000 54.80 53.39 54.32 272781.0 53777963.0
2016-01-05 55.3900 55.05 54.54 54.93 180637.0 34079674.0
2016-01-06 54.4001 54.05 53.64 54.32 225856.0 39518863.0
Obs: Importante ressaltar que a biblioteca do R foi desenvolvida pela comunidade como um projeto open source.
Desta forma seu suporte e duvidas deve ser feito a comunidade via Github.

DICA
O Thomson Reuters Eikon possui uma funcionalidade para visualizar quais os campos (FID) estão disponíveis para um
determinado ativo, desta forma fica mais fácil você verificar quais os campos são necessários e como chamá-los na
construção do seu aplicativo.
Este funcionalidade se chama Data Item Browser (DIB) e pode ser acessado digitando Data Item Browser na barra de
busca do Eikon.
Abaixo um exemplo do aplicativo DIB mostrando os campos disponíveis para o Google. Para utilizar o campo
Revenue (Faturamento) você deve chamar TR.Revenue no seu código, conforme o Exemplo 1.
SUPORTE
O suporte ao desenvolvimento de aplicativos utilizando as APIs da Refinitiv é realizado através do Fórum localizado
na nossa página web para desenvolvedores (com exceção para o desenvolvimento utilizando o R, uma vez que a
biblioteca para o R foi desenvolvido pela comunidade open source no GitHub, desta forma seu suporte e dúvidas
deverá ser realizado via a comunidade no Github). Para acessar a comunidade de desenvolvedores da Refinitiv é
necessário se registrar utilizando o seu e-mail corporativo. Segue os links:
Perguntas & Respostas (Fórum)
https://developers.thomsonreuters.com/eikon-apis/eikon-data-apis/qa
Maiores informações sobre Eikon Data APIs:
https://developers.thomsonreuters.com/eikon-apis/eikon-data-apis

Demais Comunidades:
https://github.com/hoenie-ams/Eikon-Python
https://github.com/TR-API-Samples
https://github.com/ahmedmohamedali/eikonapir (Integração do Eikon com o R)
DSWS (Datastream Web Service):
O Thomson Reuters Datastream Web Service atua como uma API Web Service possibilitando requisições de dados
por meio de bibliotecas específicas disponíveis para diversas linguagens de programação. É uma alternativa para
consultar os dados disponíveis na renomada base de dados Thomson Reuters Datastream. Para utilizar o DSWS não
é necessário estar com o Eikon ou o Datastream aberto.

1. Criar um Login de autenticação


Primeiramente é necessário contatar o seu gerente de relacionamento na Refinitiv ou o Suporte para pedir o acesso
a essa ferramenta. O “Datastream Child Logon ID”, também conhecido como usuário “Z”, deverá ser permissionado
para o DSWS. O usuário “Z” esta disponível somente para usuários contratados do Datastream. Uma vez
permissionado, o seu gerente ou o suporte lhe informará o seu usuário “Z” e a respectiva senha que deverá ser
utilizada no DSWS.

2. Instalar a biblioteca Python & R para DWDS


A biblioteca Python e R para o Datastream Webservice possibilita a consulta à base de dados do Datastream de
forma programática tornando-se muito útil para os usuários que buscam realizar estudos mais complexos e que
exigem maior quantidade de dados.
Execute o seguinte comando para instalar o pacote para Python:

pip install PyDSWS

Obs.: Esse comando deve ser executado no prompt (CMD). Se a pasta "Script /" da sua instalação do Python não
estiver incluída na variável de ambiente PATH, você pode até precisar navegar até essa pasta antes de executar o
comando pip.
Execute o seguinte comando para instalar o pacote DSWS para R:

require(devtools)
install_github(“CharlesCara/DatastreamDSWS2R”)

4. Let’s have some FUN!


Os exemplos abaixo mostram as sintaxes para Python e R.
Inicialize o objeto “dsdw”. Substitua ‘Z######’ e ‘YXXXXXX’ respectivamente pelo seu login (usuário Z) e senha.
Exemplo 1: Os comandos no exemplo a seguir retornarão as series de preços para as ações da Petrobras:

#python
import PyDSWS
dsdw = PyDSWS.Datastream(username=', password='YXXXXXX')
myData =dsdw.get_data(tickers='BR:PET', fields='P', start='2017-01-01', end='2018-08-29', freq='D')
myData
#R
library(DatastreamDSWS2R)
options(Datastream.Username = "Z######")
options(Datastream.Password = " YXXXXXX ")
mydsws <- dsws$new()

Inicio<-as.Date("2017-01-01")
Fim<-as.Date("2018-08-29")

myData <- mydsws$timeSeriesRequest(instrument = "BR:PET",


datatype = "P",
startDate = Inicio,
endDate = Fim,
frequency = "D")

myData
Abaixo a saída dos comandos:

BR.PET
30/12/2016 16.94
02/01/2017 16.53
03/01/2017 17.58
04/01/2017 17.37
05/01/2017 17.76
06/01/2017 17.49
09/01/2017 17.32
10/01/2017 17.61
11/01/2017 18.05
12/01/2017 18.35

DICA: http://datastream.thomsonreuters.com/browse/
Através do link acima é possível explorar os dados e os tipos de conteúdos disponíveis na base de dados do
Datastream, bem como descobrir os códigos que são usados como Input nas funções. Além de ser possível identificar
descrições e detalhes sobre os dados.
SUPORTE
O suporte ao desenvolvimento de aplicativos utilizando as APIs da Refinitiv é realizado através do Fórum localizado
na nossa página web para desenvolvedores (com exceção para o desenvolvimento utilizando o R, uma vez que a
biblioteca para o R foi desenvolvido pela comunidade open source no GitHub, desta forma seu suporte e dúvidas
deverá ser realizado via a comunidade no Github). Para acessar a comunidade de desenvolvedores da Refinitiv é
necessário se registrar utilizando o seu e-mail corporativo. Segue os links:
Perguntas & Respostas (Fórum)
https://developers.thomsonreuters.com/eikon-apis/datastream-web-service/qa

Maiores informações sobre DSWS:


https://developers.thomsonreuters.com/eikon-apis/datastream-web-service

Demais Comunidades:
https://github.com/hoenie-ams/PyDSWS
https://github.com/CharlesCara/DatastreamDSWS2R (Integração do Eikon com o R)

Você também pode gostar