Introdução

Entenda mais sobre esse recurso

A API Trading fornece todos os serviços necessários para negociação de ativos no mercado de Renda Variável. Dentre suas funcionalidades, destacam-se:

  • Envio de ordens de compra e venda de ativos;
  • Edição e cancelamento de ordens;
  • Consulta de ordens do dia e do histórico de ordens;
  • Consulta de informações sobre a conta.

Para que uma requisição seja feita, é necessário que o usuário se autentique previamente à plataforma. Para maiores informações sobre como se autenticar, acesse os menus a seguir:

Como obter suas credenciais de acesso

Autenticação

Antes de efetuar a chamada para alguns endpoints, é necessário se autenticar gerando um objeto chamado user-identifier que deverá ser passado no cabeçalho desta chamada após ser aplicado uma criptografia que pode ser BASE64 ou RSA de acordo com a configuração do webfeeder (em caso de dúvidas, consultar a Cedro).

Abaixo segue um exemplo utilizando uma criptografia BASE64:

Formato do user-identifier
{"id":"1","user_name":"conta","login_oms":"conta","password":"senha","remote_ip":"ip"}

Exemplo do user-identifier
{"id":"1","user_name":"10034","login_oms":"10034","password":"123456*","remote_ip":"127.0.0.1"}

Exemplo do user-identifier após aplicar a criptografia BASE64
eyJpZCI6IjEiLCJ1c2VyX25hbWUiOiIxMDAzNCIsImxvZ2luX29tcyI6IjEwMDM0IiwicGFzc3dvcmQiOiIxMjM0NTYqIiwicmVtb3RlX2lwIjoiMTI3LjAuMC4xIn0.

Fluxo transacional

Informações importantes

Após solicitar as credenciais de acesso, você receberá os dados de usuário e senha. Caso você ainda não tenha solicitado suas credenciais, entre em contato com o nosso time de especialistas pelo e-mail [email protected] ou ligue para o telefone (34) 3239-0000.

Evento de autenticação
A autenticação é realizada por meio do serviço /brokerServiceLogin. Este serviço possui em seu retorno um conjunto de dados que indica se a conexão foi estabelecida ou não.

📘

Para obter mais informações sobre este serviço, acesse a página de autenticação.