SHARKRULE / Aprender

Chave API para robô de trading: permissões e segurança

Uma chave API permite que um programa consulte sua conta ou envie operações dentro das permissões concedidas. Antes de conectar um robô à corretora, defina a tarefa, o limite e a forma de interrompê-la. Segurança da credencial e controle da operação precisam funcionar juntos.

SharkRule · Revisado em

Conectar a corretora é diferente de conectar uma carteira

A API autoriza um software a interagir com a conta da corretora. Esse procedimento não exige a frase de recuperação de uma carteira de autocustódia. Chave API, segredo API e chave privada de uma carteira são credenciais de sistemas diferentes; não devem ser tratados como campos intercambiáveis.

Os ativos dessa conta continuam sob custódia da corretora. Mesmo sem permissão de saque, um robô pode realizar operações desfavoráveis e gerar prejuízos. A opção «saques desativados» limita uma ação específica; não protege o saldo contra qualquer uso indevido de uma permissão de negociação.

Conceda acesso conforme a tarefa

Peça uma explicação para cada permissão solicitada. Um painel de acompanhamento, um robô que envia ordens e uma ferramenta de declaração de operações podem ter necessidades diferentes. Use uma credencial dedicada para cada finalidade.

O que revisar antes de salvar as permissões
FinalidadeAcesso a justificarPergunta de revisão
Acompanhar cotaçõesDados públicos, quando suficientesPrecisa acessar minha conta?
Mostrar saldoLeitura dos dados necessáriosFunciona sem enviar ordens?
Executar regrasCriar, consultar e cancelar ordensComo evita uma ordem duplicada?
Gerar relatóriosLeitura do histórico pertinentePor que usaria a chave do robô?
Sacar ou transferir ativosPermissões financeiras adicionaisDeixe desativadas para um robô que só negocia

Prepare uma conexão que você consiga revisar

Se o robô roda na nuvem, o IP que importa costuma ser o do servidor que faz a solicitação. Não copie automaticamente o IP do seu computador. Combine como o fornecedor informa alterações e evite liberar todos os endereços para fazer a conexão voltar a funcionar.

  1. Acesse o domínio oficial da corretora e proteja o login com os controles de segurança disponíveis.
  2. Crie uma chave exclusiva e registre nome, finalidade e data de criação, sem guardar o segredo nessa ficha.
  3. Comece pela leitura necessária e só autorize negociação após definir os limites da operação.
  4. Quando disponível, restrinja o acesso aos IPs de saída confirmados do serviço.
  5. Armazene credenciais de forma criptografada; não as envie em chats, capturas de tela, código ou registros de erro.
  6. Localize a revogação na corretora e ensaie como verificar ordens sem depender do robô.

Transforme o orçamento em uma regra verificável

Descreva pares autorizados, valor máximo por ordem, frequência, limite total e condições de pausa. Defina se o cálculo considera ordens em aberto e taxas. Uma limitação dentro do aplicativo não é necessariamente uma restrição aplicada pela corretora; identifique quem consegue alterá-la e como ela é fiscalizada.

Exemplo fictício: uma regra pode comprometer 100 unidades da moeda de cotação. Já foram executadas 35 e há 25 reservadas em uma ordem pendente. Restam no máximo 40 antes das taxas. Se o robô contabilizar apenas a parte executada, poderá tentar comprometer mais 65. O exemplo mostra por que o saldo de uma estratégia não deve ignorar ordens abertas; não indica um valor adequado para investir.

Diferencie desligamento normal de vazamento

Ao deixar de usar um serviço, pause novas ações, confira ordens pendentes e execuções, cancele o que for necessário e confirme os resultados. Depois, retire o acesso. Não presuma que fechar o aplicativo ou excluir a chave vende ativos ou cancela tudo. Mantenha acesso direto à corretora.

Se houver suspeita de vazamento, revogue imediatamente a credencial afetada na corretora e examine a atividade por esse canal. Não espere concluir o desligamento habitual. Guarde horários e identificadores sem segredos, procure o suporte oficial e só gere uma substituta após resolver a origem da exposição.

Perguntas frequentes

Um robô sem saque habilitado ainda pode causar prejuízo?

Sim. Ordens ruins, duplicações, excesso de negociações e taxas podem consumir o saldo. Restringir saques não elimina o risco de trading.

Posso usar uma chave para o robô e para meus relatórios?

Chaves separadas facilitam conceder apenas o acesso necessário, investigar problemas e desligar um serviço sem afetar o outro.

Preciso informar as palavras da minha carteira?

Não para conectar a API de uma corretora. A frase de recuperação não faz parte do procedimento descrito neste guia.

Fontes oficiais

Elaborado com auxílio de IA a partir da documentação oficial indicada. Os exemplos são hipotéticos; não foram realizados testes em contas reais nem comparações de rentabilidade.