Conectar a exchange PIONEX
O Bybot opera na sua conta da Pionex por meio de uma chave de API. Seus fundos ficam na exchange: a chave permite que o bot veja seu saldo e envie ordens spot. As chaves de API da Pionex não têm nenhuma permissão de saque, então não dá para sacar fundos pela chave. A configuração leva cerca de 5 minutos.
O que você precisa
- Uma conta na Pionex — cadastre-se
- Autenticação de dois fatores ativada na Pionex — a exchange pede códigos de verificação ao criar uma chave
- USDT na sua conta de trading da Pionex: pelo menos 10 USDT para cada compra DCA
- Menos de 10 chaves de API na conta — a Pionex não permite mais de 10
1. Entre na Pionex
Ainda não tem conta? Crie uma. Se a Pionex pedir verificação de identidade antes de criar chaves de API, faça isso primeiro.
2. Abra API management
Clique no ícone do perfil no canto superior direito e selecione “API management”, ou abra pionex.com/en/apiManagement.
3. Clique em “Create API”
Crie uma chave nova só para o bot mesmo que você já tenha uma: o motivo está em “Validade da chave” abaixo. Na mesma página a Pionex lembra dois limites: até 10 chaves de API por conta, e uma chave sem endereço IP vale 90 dias. Se a conta já tiver 10 chaves, exclua as que você não usa mais.
4. Configure a chave
Na janela “Create API KEY”:
| Campo | O que selecionar |
|---|---|
| API Label | Qualquer um, por exemplo bybot |
| Enable reading | ✅ ativado (sempre, não dá para desativar) |
| Enable trading | ✅ ativar |
| Bot reading | ❌ desativado |
| Bot trading | ❌ desativado |
| Earn | ❌ desativado |
| Restrict access to trusted IPs only (Optional) | deixe vazio |
“Bot reading”, “Bot trading” e “Earn” dão acesso aos bots da própria Pionex e ao Earn; o Bybot não precisa deles. Não há opção de saque para desativar: as chaves de API da Pionex não fazem saques. Clique em “Submit”.
Não adicione endereços IP. O Bybot se conecta pelos próprios servidores, e uma chave vinculada a um IP não vai funcionar com eles.
5. Confirme a criação da chave
Na janela “Verify your identity”, clique em “Send” e digite o código do seu e-mail e depois o código do Google Authenticator. Clique em “Confirm”.
6. Copie a API Key e o Api Secret
A página “API created” mostra a API Key e o Api Secret. Copie os dois pelos botões de copiar e guarde em um lugar seguro. Confira se API restrictions mostra Enable reading, Enable trading e IP access restrictions mostra Not set.
O Api Secret aparece só uma vez. A Pionex esconde o Secret quando você sai desta página. Se perder, exclua a chave e crie uma nova.
7. Adicione as chaves no Bybot
No Bybot, abra Configurações (“Settings”) → Chaves de API (“API Keys”) e clique em Adicionar chave (“Add key”). Selecione PIONEX, cole a API Key e o Secret e clique em Salvar (“Save”).
O Bybot verifica a chave na hora: ela precisa ler seu saldo e ter o trading ativado. O cartão da chave mostra a data em que a Pionex vai excluí-la: 90 dias depois de você adicioná-la.
8. Confira seu saldo
O bot opera só com os USDT da sua conta de trading. Fundos dentro dos bots da Pionex (Grid e outros) e no Earn não aparecem pela API, então o bot não consegue usá-los. Pare o bot da Pionex ou resgate do Earn e confirme que os USDT voltaram para a conta de trading.
Cada compra DCA na Pionex precisa ser de pelo menos 10 USDT. Considere esse mínimo ao definir o tamanho das ordens e o orçamento total.
Validade da chave
A Pionex exclui uma chave de API sem vínculo de IP 90 dias após a criação. O Bybot conta esses 90 dias a partir do momento em que você adiciona a chave, então uma chave mais antiga expiraria antes da data do Bybot e o bot pausaria sem aviso. Por isso você cria uma chave nova só para o bot.
Alguns dias antes da data, o Bybot envia um lembrete. “Check key” não estende a chave, e a Pionex também não estende. Para substituir a chave:
- Crie uma chave nova na Pionex com este guia.
- No Bybot, abra Configurações (“Settings”) → Chaves de API (“API Keys”) e exclua a chave antiga da Pionex.
- Adicione a chave nova.
Se a chave já expirou, o bot fica pausado até você adicionar uma nova.
O que saber sobre a Pionex
- Taxa: 0,05% por ordem. Na compra, a Pionex cobra a taxa na moeda, então chega um pouco menos que o volume comprado. O Bybot leva isso em conta.
- Pares: 22 pares spot. Dos pares com USDC, só BTC e ETH estão disponíveis.
- Ordem mínima: 10 USDT por compra, mais do que em algumas outras exchanges. Com um depósito pequeno, confira se a estratégia cabe nele.
- Conexões: a Pionex permite no máximo 10 conexões simultâneas por conta. Se a mesma conta estiver ligada a vários outros bots ou terminais, o Bybot pode ficar sem conexão. Ele continua operando, mas vê as execuções com mais atraso.
Segurança da chave
- Saques são impossíveis. As chaves de API da Pionex não têm permissão de saque.
- O Bybot nunca vai pedir sua senha da Pionex nem códigos 2FA.
- Nunca envie o Secret em chats, capturas de tela, tickets ou documentos compartilhados.
- Se a chave vazar ou você parar de usar o bot, exclua-a na página API management da Pionex. O acesso termina na hora.
Problemas comuns
“A Pionex rejeitou a chave”. Confira se você copiou a API Key e o Secret inteiros, sem espaços extras. Se a chave foi excluída ou tem mais de 90 dias, crie uma nova. Se a chave tem um endereço IP, crie uma chave nova sem IP.
“A chave não tem permissão de trading”. Ative Enable trading nas configurações da chave na Pionex e adicione a chave no Bybot de novo.
O bot pausou depois de uns 3 meses. A Pionex excluiu a chave 90 dias após a criação. Crie uma chave nova com este guia e substitua a antiga no Bybot.
O bot não vê o saldo. Os USDT estão em um bot da Pionex ou no Earn. Devolva-os para a conta de trading.
Não consigo criar uma chave. A conta já tem 10 chaves. Exclua as que não usa.
Perdi o Secret. A Pionex mostra o Secret só uma vez. Exclua a chave, crie uma nova e adicione no Bybot.
Página oficial da exchange: Pionex API management.