Pular para o conteúdo principal

Conectar uma corretora

Cada conta de corretora que você adicionar no Trade pode atender a uma ou mais combinações. O Trade verifica a conta antes de salvá-la.

Adicionar uma conta

  1. No Trade, abra Contas e escolha Adicionar conta.

  2. Escolha a corretora.

  3. Informe o nome da conta, o account mode, os mercados e a chave de API. A maioria das corretoras usa uma chave de API e um secret, algumas também uma passphrase; algumas se conectam por carteira.

  4. Salve. O Trade verifica a chave de API, o modo da conta, o position mode e a permissão de negociação, e depois mostra o status da conexão. Se a conta foi salva, mas não conectou, escolha Tentar conectar de novo.

Na Hyperliquid e na Aster, só é possível adicionar a conta principal da própria carteira principal. Subcontas e cofres não são compatíveis. Uma conta gratuita (Standard) na Lighter ou na Lighter on Robinhood Chain precisa migrar para o Plus antes de ser adicionada; o Trade pergunta antes de atualizar o plano.

Permissões de API

Cada corretora nomeia e divide suas permissões de maneira diferente. Na seção Chave de API, a janela de adicionar conta lista as permissões que esta corretora exige para o modo de conta e os mercados escolhidos, usando os nomes exatos da página de gerenciamento de API da corretora, com um link para essa página quando ela tem um endereço estável:

  • Enable: o que a operação exige, cada item seguido do que o Trade faz com ele.

  • Enable to transfer: só para quando você faz transferência de fundos no Trade; caso contrário, deixe desativada. Quando as chaves de API da conta principal e da subconta exigem permissões diferentes, a janela informa.

  • Turn off: opções somente leitura que bloqueiam ordens enquanto estão ativadas, como o Read Only da Backpack.

  • Don’t enable: saques. O ZML Trade não precisa nem usa permissão de saque.

Corretoras conectadas com uma carteira não têm permissões a configurar. As corretoras que informam as permissões da chave de API recusam uma chave de API somente leitura, ou uma cuja permissão de negociação esteja claramente desativada para um mercado selecionado. Backpack, GRVT, edgeX e Gate CrossEx não informam permissões, portanto elas não são verificadas ao salvar; confira-as na corretora com base na lista da janela.

Lista de IPs permitidos

Para corretoras cujas chaves de API aceitam uma IP allowlist, a janela de adicionar conta lista os egress IP do seu servidor. Escolha Copiar todos os IPs de saída e adicione-os à lista de permissões da chave de API na corretora. Hyperliquid, Lighter, Lighter on Robinhood Chain, Nado, Extended e Arcus não têm lista de permissões de IP, por isso a janela não lista IPs de saída para elas. A Aster conectada com uma carteira não tem restrição de IP. Se você informar uma API wallet manualmente e a tiver restringido a determinados IPs na Aster, adicione os IPs de saída lá também.

Modo da conta e da posição

O modo da conta escolhido deve corresponder ao da conta na corretora. O Trade não o altera por você; em caso de divergência, o salvamento falha e informa o que deve ser alterado.

Ao salvar, o Trade define o modo de posição de que precisa. Se a corretora recusar porque há posições ou ordens abertas, feche-as ou aguarde e salve novamente.

Armazenamento das chaves

As chaves são criptografadas no seu servidor e nunca são enviadas à ZML. Depois de salvar, apenas uma chave mascarada é exibida; para alterar uma chave, informe uma nova.