O que esse erro significa

Esse erro aparece quando você está usando subcontas da Binance. A Whitelist de Símbolos de Trading de API da Binance restringe o trading de API Spot/Margin de uma subconta a um conjunto de pares selecionados pela Conta Master. Se o seu bot tentar negociar um par que não está na lista de permissões, você verá este erro.

Como configurar a Whitelist de Símbolos

1. Faça login na sua conta Binance e clique em [Perfil] → [Sub Contas].

Guia de solução de problemas da Cryptohopper: menu de perfil da Binance mostrando a opção Sub Contas para configuração de whitelist de API, com caminho de navegação através do ícone de Perfil para resolver erro de bot de trading com símbolo não whitelisto

2. Vá para [Gerenciamento de API] em [Sub Contas] à esquerda. Encontre a subconta para a qual você deseja habilitar a whitelist de símbolos e clique em [Modificar] ao lado dela.

3. Você será redirecionado para a página de Gerenciamento de API. Clique em [Modificar], depois marque a caixa ao lado de [Habilitar Whitelist de Símbolos].

Guia de configuração da Cryptohopper: painel de modificação de Gerenciamento de API da Binance mostrando a caixa de seleção 'Habilitar Whitelist de Símbolos' com o botão Editar, apresentando configurações de segurança de API e restrições para configuração de bot de trading automatizado

4. Clique em [Editar] ao lado de [Habilitar Whitelist de Símbolos] para configurar os pares da whitelist. Você pode procurar por pares de símbolos aqui. Clique em [Adicionar] para adicionar um par à whitelist. Você pode adicionar até 30 pares por API de subconta.

Guia de configuração da Cryptohopper: modal de Whitelist de Símbolos Spot & Margin da Binance mostrando seleção de pares de negociação BTC com opções Adicionar/Remover, funcionalidade de pesquisa e limite de 30 pares para configuração de API de bot de trading

5. Você também pode ver os pares mais populares. Clique em [Adicionar] para adicionar um par à whitelist.

Guia de integração da Cryptohopper: visualização dos principais pares de negociação da Whitelist de Símbolos da Binance mostrando BTC/USDT, SOL/USDT, XRP/USDT, BNB/USDT e ETH/USDT com botões Adicionar para configuração de bot de trading automatizado

6. Clique em [Importar de favoritos] para ver seus pares de negociação favoritos e adicioná-los à whitelist.

Guia de configuração da Cryptohopper: configuração da Whitelist de Símbolos da Binance mostrando a guia 'Importar de favoritos' com pares adicionados BTC/USDT e BTC/BUSD, demonstrando a importação de pares de negociação favoritos para bot de trading automatizado

7. Para remover um par da whitelist, clique em [Remover] ou [x] ao lado dele. Quando terminar de selecionar os pares, clique em [Confirmar].

Guia de configuração da Cryptohopper: gerenciamento da Whitelist de Símbolos da Binance mostrando o botão Remover e opções de exclusão 'x' para pares de negociação, com o botão Confirmar para salvar as alterações da whitelist para configuração de bot de trading automatizado

8. Clique em [Editar] novamente para revisar os pares whitelisto. Uma vez confirmando, clique em [Salvar] na página [Gerenciamento de API].

Guia de configuração de API da Cryptohopper: tela final de configuração de Gerenciamento de API da Binance com o botão Salvar destacado, mostrando Whitelist de Símbolos habilitada e restrições de API para integração de bot de trading automatizado

9. Verifique a solicitação com 2FA.

Configuração de segurança da Cryptohopper: modal de verificação de segurança de Gerenciamento de API da Binance mostrando requisitos de verificação em duas etapas com opções de Aplicativo Autenticador e E-mail (0/2 concluídas) para configuração de API de bot de trading

Você verá que a caixa [Habilitar Whitelist de Símbolos] agora está marcada. Esta subconta só poderá negociar os pares selecionados nos mercados Spot/Margin via API.

Integração concluída da Cryptohopper: página de Gerenciamento de API da Binance mostrando a caixa de seleção Whitelist de Símbolos habilitada com permissões de negociação restritas para bot de trading automatizado, confirmando limitações de pares de negociação Spot e Margin

Sobre a Whitelist de Símbolos de Trading de API

A Whitelist de Símbolos de Trading de API permite que você restrinja o trading Spot/Margin das subcontas apenas aos pares selecionados pela Conta Master. Ela está disponível para Contas Master que configuraram APIs para subcontas normais.

Veja o que ela oferece:

Gerenciamento flexível de trading — Equipes de trading podem atribuir pares específicos a traders específicos configurando a whitelist por subconta.
Segurança aprimorada — Se suas chaves de API forem comprometidas, partes não autorizadas não poderão negociar pares que não estejam na whitelist.
Configuração fácil — Equipes de trading podem facilmente encontrar e selecionar pares de negociação para adicionar à whitelist. Cada API de subconta suporta até 30 pares.

Lembre-se: a whitelist afeta apenas o trading de API. As subcontas ainda podem negociar qualquer par diretamente no site da Binance. O recurso está atualmente disponível para trading Spot/Margin em subcontas normais e gerenciadas apenas.

Para mais informações sobre subcontas, consulte Como Gerenciar Funções de Subconta e Perguntas Frequentes.

Por que eu recebo o erro "Symbol not whitelisted for API key" na Binance?

O que esse erro significa

Como configurar a Whitelist de Símbolos

Sobre a Whitelist de Símbolos de Trading de API