Como ligo um terminal de trading ou bot de terceiros à minha Conta OKX?
Qual é a diferença entre uma ligação de corretor e uma ligação por chave de API?
Um terminal ou bot de terceiros pode atuar sobre a sua Conta OKX de duas formas, e ambas são configuradas em locais diferentes.
Uma ligação de corretor é configurada dentro da ferramenta de terceiros: inicia sessão nesta e autoriza a OKX como corretor para essa ferramenta, e a ferramenta encaminha depois as suas ordens através dessa ligação autorizada. Aquilo que a ligação pode negociar é determinado pela própria ligação, e não por algo que introduza na ferramenta.
Uma ligação por chave de API utiliza uma chave que cria na sua própria Conta OKX e cola na ferramenta. A ferramenta atua exatamente com as permissões que concedeu a essa chave, e pode alterar ou eliminar a chave na sua Conta OKX a qualquer momento.
Saber qual está a utilizar diz-lhe por onde começar: uma ligação de corretor é reautorizada na ferramenta de terceiros, enquanto uma ligação por chave de API é gerida a partir das definições de API na sua Conta OKX.
Que permissões devo dar a uma chave de API utilizada por uma ferramenta de terceiros?
Dê a uma chave o acesso mínimo de que a ferramenta necessita, e nada mais.
Conceda permissão de trading apenas se a ferramenta colocar ordens por si. Não ative a permissão de levantamento para uma integração de trading — colocar e gerir ordens não requer essa permissão.
Trate a chave secreta como uma palavra-passe. Guarde-a num gestor de palavras-passe e não a cole num chat, numa captura de ecrã ou num pedido de apoio.
Utilize uma chave por ferramenta. Assim, pode desativar uma única ferramenta sem afetar as restantes.
Se uma chave puder ter sido exposta, elimine-a primeiro na sua Conta OKX e depois crie uma substituta. Eliminar a chave impede a ferramenta de atuar sobre a sua conta.
Restrinja a chave aos endereços IP que a ferramenta documenta, caso os documente, e reveja periodicamente as suas chaves para remover as que já não utiliza.
As definições e passos atuais da chave encontram-se nas Perguntas frequentes sobre a API.
Como criar uma chave de API se só tenho a aplicação da OKX?
Não precisa de um computador para criar uma chave de API. Na aplicação da OKX, vá a Menu > API > Criar chave de API, depois conceda as permissões de que a ferramenta necessita e guarde a chave em segurança. Os passos para a aplicação e para o site encontram-se nas Perguntas frequentes sobre a API.
Porque é que uma ferramenta de terceiros indica que o símbolo não é transacionável?
Um erro como "símbolo não transacionável" significa que o identificador enviado pela ferramenta não corresponde a um instrumento que a sua ligação possa negociar. Por si só, não é uma afirmação sobre a sua conta nem sobre as suas permissões de trading.
Divida o identificador nas suas partes antes de tirar qualquer conclusão:
o ativo base ao qual pretende ter exposição
a moeda de cotação ou a moeda de liquidação
a família de produtos — à vista, margem ou futuros
Uma ferramenta de terceiros apresenta frequentemente uma etiqueta abreviada ou reformatada, pelo que duas etiquetas com aparência semelhante podem apontar para instrumentos diferentes e uma etiqueta, por si só, não lhe indica o que a sua ligação pode negociar. Compare-a com o identificador do instrumento tal como a OKX o apresenta na página de trading e, quando a ferramenta oferecer o seu próprio seletor de instrumentos, selecione aí o instrumento em vez de escrever a etiqueta manualmente.
Se o mesmo identificador continuar a ser rejeitado, registe o identificador exatamente como a OKX o apresenta, o texto exato do erro e a hora, e contacte o suporte com os três elementos.
Porque é que uma ferramenta de terceiros mostra o meu saldo como zero?
Verifique estes quatro pontos na sua Conta OKX, por esta ordem:
Onde estão os fundos. Uma integração só vê os saldos a que a ligação tem acesso. Se os seus fundos estiverem noutro local, transfira-os para a sua conta de trading.
Se o saldo já está comprometido. As ordens abertas e as posições abertas retêm margem, pelo que o seu saldo disponível pode ser muito menor do que o seu saldo total.
Se a ligação ainda está autenticada. Uma chave pode ser eliminada ou perder uma permissão, e uma autorização de corretor pode expirar. Voltar a autorizar a ligação, ou criar uma nova chave com as permissões de que a ferramenta necessita, restaura o acesso.
Se a ferramenta está apontada para a conta certa. Uma subconta detém o seu próprio saldo, e uma chave criada para uma conta não vê os fundos de outra conta.
O que devo reunir antes de contactar o suporte sobre uma ligação de terceiros?
Uma verificação diz-lhe qual das partes deve contactar: coloque a mesma ordem diretamente na OKX. Se for executada na OKX mas a ferramenta a rejeitar, a rejeição vem da integração, pelo que deve reportá-la ao suporte da própria ferramenta. Se também falhar na OKX, contacte o OKX Assistant.
Em qualquer dos casos, recolha primeiro o seguinte para que o problema possa ser rastreado sem uma segunda ronda de perguntas:
o código de erro e a mensagem de erro exatos, copiados em vez de parafraseados
o identificador do instrumento tal como foi enviado pela ferramenta e tal como é apresentado pela OKX
a data e hora, com o seu fuso horário
se está a utilizar uma ligação de corretor ou uma chave de API e quais as permissões que a chave tem
o registo de ligação ou o registo de atividade da ferramenta de terceiros
se a mesma ordem funciona quando a coloca diretamente na OKX
As definições da sua conta podem afetar o que uma integração consegue negociar. Envie o texto exato do erro ao suporte em vez de alterar as definições da conta ao acaso, para que a causa possa ser identificada antes de qualquer alteração.