TUTORIAL · CONFIGURAÇÃO DE API

Configurar API

TUTORIAL · IA COPY TRADER

Configure sua API

Binance, Bybit e OKX. Do zero à conexão aprovada.

A API é a ponte entre a sua conta na corretora e a IA Copy Trader. Siga na ordem, pelo computador, e ao final o painel vai confirmar a conexão sozinho. A permissão de saque permanece desativada do começo ao fim, nas três corretoras.

6
PASSOS ATÉ CONECTAR
0
PERMISSÃO DE SAQUE
1
IP AUTORIZADO
CORRETORA Binance MOTOR Next Defi CHAVE API •••• •••• Leitura ATIVADA Negociação de Futuros ATIVADA Transferência universal DESATIVADA Saques DESATIVADA
1 PASSO 1
Prepare sua conta
2 PASSO 2
Crie a chave API
3 PASSO 3
Guarde as informações
4 PASSO 4
Configure as permissões
5 PASSO 5
Restrinja por IP
6 PASSO 6
Conecte ao robô
Leia antes de começar

Nunca envie API Key, Secret Key, senha da Binance, código 2FA ou frase de recuperação por WhatsApp, Telegram, e-mail ou chat. As chaves devem ser digitadas apenas no painel seguro do robô. Cada cliente cria a própria API dentro da conta dele, a Next Defi não recebe nem armazena senha, 2FA ou frase de recuperação.

Binance 6 PASSOS
Futuros USDⓈ-M. Duas chaves: API Key e Secret Key.
VER O TUTORIAL
Bybit 8 PASSOS
Conta Unificada e Linear USDT Perpetual. Duas chaves.
VER O TUTORIAL
OKX 8 PASSOS
Modo de Futuros e SWAP. Três informações, com Passphrase.
VER O TUTORIAL
B
CORRETORA 1 DE 3
Como configurar a Binance
6 passos
01

Prepare sua conta

Antes de criar a API, a Binance exige que sua conta cumpra alguns requisitos. Se algum estiver pendente, a criação da chave é bloqueada.

Requisitos informados no guia oficial da Binance.

Abrir o guia oficial
Verificação de identidade concluída
O KYC precisa estar aprovado na sua conta.
OBRIGATÓRIO
Autenticação em dois fatores ativada
Aplicativo autenticador configurado e funcionando.
OBRIGATÓRIO
Conta de Futuros ativada
Necessário caso o robô opere no mercado de Futuros.
SE USAR FUTUROS
Algum depósito na carteira Spot
A Binance pode solicitar antes de liberar a criação da API.
SE SOLICITADO
02

Crie a chave API

Entre no site oficial da Binance pelo computador e siga o caminho abaixo. Confirme com e-mail, autenticador e demais verificações solicitadas.

CAMINHO NO SITE
Site oficial Ícone do perfil Conta Gerenciamento de API Criar API
Dê um nome à chave, por exemplo BOT NEXT DEFI, para você reconhecer depois na lista., para você reconhecer depois na lista.
TIPO DE CHAVE
ÚNICA OPÇÃO ACEITA

Gerada pelo sistema

É o tipo que a Next Defi usa. O painel pede apenas as duas chaves de texto que a Binance mostra na criação.

RETORNA
API Key
Secret Key
A Secret Key normalmente aparece apenas uma vez. Copie e guarde num lugar seguro antes de fechar a tela.
03

Guarde as duas informações

A Binance mostra duas informações. Copie as duas na mesma hora, a Secret Key não é exibida novamente.

Gerenciador de senhas ou cofre digital da sua confiança
Digitadas direto no painel seguro do robô, uma única vez
Nunca em WhatsApp, Telegram, e-mail, chat ou bloco de notas compartilhado
TELA DA BINANCE
API KEY pode ser consultada depois
xLm7Qd9…a4Kf2Zt
SECRET KEY aparece apenas uma vez
••••••••••••••••••••••••
Nunca envie essas chaves por WhatsApp, Telegram, e-mail ou chat. Digite direto no painel do robô.
04

Configure as permissões

Clique em Editar restrições e marque somente o necessário. Cada uso pede uma permissão diferente.

USO DA APIPERMISSÃO NECESSÁRIA
Apenas consultar saldo Ativar leitura
Consultar ordens e posições Ativar leitura
Operar no mercado Spot Ativar negociação Spot
Operar em Futuros Ativar negociação de Futuros
Fazer saques Não ativar
CONFIGURAÇÃO PARA FUTUROS USDⓈ-M
É como o robô normalmente opera na Next Defi.
Permitir leitura ATIVADA
Negociação de Futuros ATIVADA
Negociação Spot DESATIVADA
Margin DESATIVADA
Transferência universal DESATIVADA
Permitir saques DESATIVADA
A permissão de saque deve permanecer totalmente desativada. O robô não precisa dela para abrir ou fechar operações.
05
PROTEÇÃO MAIS IMPORTANTE

Restrinja por endereço IP

Escolha Restringir acesso somente a IPs confiáveis e adicione o IP do servidor da Next Defi, abaixo. Sem esse endereço na lista, a conexão é recusada.

IP DO SERVIDOR NEXT DEFI
167.233.209.88
Adicione somente o IP 167.233.209.88, é o servidor fixo onde o robô da Next Defi está hospedado.
Não coloque o IP da sua internet residencial: ele muda sozinho e bloqueia a conexão. O robô não opera do seu computador, e sim do servidor com IP fixo.
SERVIDOR NEXT DEFI 167.233.209.88 BINANCE API whitelist de IP ativa IP RESIDENCIAL muda sozinho bloqueia a conexão PARA OPERAÇÃO 24 HORAS Somente 167.233.209.88, nunca o IP da sua internet.
06

Conecte ao robô

No painel do robô, preencha os quatro campos e clique em testar conexão.

PAINEL NEXT DEFI · CONECTAR CORRETORA
Binance
chave fornecida pela Binance
••••••••••••••••••••
Futuros USDⓈ-M
Testar conexão Verificar API Conectar Binance
O SISTEMA DEVE CONFIRMAR
Conta localizada OK
Saldo consultado OK
Permissão de Futuros ativada OK
IP autorizado OK
Chave válida OK
Antes de colocar dinheiro real, faça uma operação pequena ou use o ambiente de demonstração da Binance, ela tem uma área própria para testar a API de Futuros com negociação demo.
RESUMO

Configuração ideal para o seu robô

Confira este quadro ao final. Se algo estiver diferente, volte ao passo correspondente.

NOME
NEXT DEFI BOT
para reconhecer na lista
LEITURA
Ativada
saldo, ordens e posições
SPOT
Desativada
se não utilizar
MARGIN
Desativada
o robô não utiliza
FUTUROS
Ativada
mercado de operação
SAQUES
Desativados
nunca ativar
RESTRIÇÃO DE IP
Ativada
somente IPs confiáveis
IP
167.233.209.88
servidor da Next Defi
DIAGNÓSTICO

Se aparecer algum erro

Estes são os cinco mais comuns. Clique para ver a causa e o que fazer.

Invalid API Key +
CAUSA

A chave foi digitada com erro, tem espaço extra no começo ou fim, ou foi apagada na Binance.

O QUE FAZER

Copie novamente a API Key na Binance e cole sem espaços. Se a chave foi excluída, crie outra pelo passo 2.

VOLTAR AO PASSO 3
IP not allowed +
CAUSA

O IP que está tentando acessar não está na lista de IPs confiáveis da chave.

O QUE FAZER

Confira se o IP 167.233.209.88 está na restrição de IP da chave, digitado exatamente assim, sem espaços.

VOLTAR AO PASSO 5
Futures permission disabled +
CAUSA

A permissão de negociação de Futuros não foi marcada, ou a conta de Futuros não está ativada.

O QUE FAZER

Ative a conta de Futuros na Binance e marque "Permitir negociação de Futuros" em Editar restrições.

VOLTAR AO PASSO 4
Signature error +
CAUSA

A Secret Key está incorreta, incompleta ou foi colada com caractere sobrando.

O QUE FAZER

Recrie a chave escolhendo "Gerada pelo sistema" e informe a Secret Key completa, sem cortes nem espaços.

VOLTAR AO PASSO 3
Timestamp outside recvWindow +
CAUSA

O relógio do servidor onde o robô roda está fora de sincronia com o horário da Binance.

O QUE FAZER

Sincronize o relógio do servidor por NTP. Sua equipe técnica resolve isso na VPS.

VOLTAR AO PASSO 6
BY
CORRETORA 2 DE 3
Como configurar a Bybit
8 passos
Faça pelo computador. A Bybit não permite criar a chave pelo aplicativo. O robô opera Futuros na Conta de Negociação Unificada.
01

Prepare sua conta

Antes de começar, a conta precisa cumprir quatro requisitos. Sem eles, a criação da chave é bloqueada.

A Bybit pode bloquear a criação de API durante as primeiras 48 horas após o cadastro de uma conta nova.
Conclua a verificação de identidade KYC aprovado na conta.
Ative o Google Authenticator Aplicativo autenticador configurado.
Ative sua Conta de Negociação Unificada É a conta que o robô utiliza.
Confirme que consegue operar contratos perpétuos normalmente Teste manualmente antes de criar a chave.
02

Acesse o Gerenciamento de API

Entre no site oficial e siga o caminho abaixo. Depois clique em Criar nova chave.

Abrir o Gerenciamento de API
CAMINHO NO SITE
Perfil Conta e Segurança Gerenciamento de API Criar nova chave
03

Escolha o tipo correto

Configure a chave como gerada pelo sistema, com uso para transações via API.

Escolha Transações via API quando o seu sistema não aparecer na lista oficial de aplicativos parceiros da Bybit. A chave gerada pelo sistema usa API Key e API Secret, é a opção mais simples e compatível com a maioria dos robôs.
COMO PREENCHER
TIPO Chave API gerada pelo sistema
USO Transações via API
NOME NEXT DEFI BOT
04

Defina como leitura e escrita

Para o robô abrir e fechar operações, a permissão precisa ser de leitura e escrita.

Se selecionar apenas leitura, o robô conseguirá consultar saldo, ordens e posições, mas não poderá operar.
PERMISSÃO
MODO Leitura e escrita
05

Marque somente as permissões necessárias

Para operar Futuros USDT, ative apenas contratos. A documentação da Bybit chama essas permissões de Order e Position.

Caso o robô também opere Spot, você pode ativar Spot Trade. Se ele operar somente Futuros, deixe desativado.
Documentação oficial da API Bybit
ÁREAPERMISSÃO
Contratos Ordens
Contratos Posições
Spot Desativada, se não utilizar
Carteira Desativada
Saques Desativados
Transferências Desativadas
Earn Desativada
P2P Desativada
Opções Desativada
06

Configure a restrição de IP

Selecione Permitir acesso somente aos IPs informados e cadastre o endereço do servidor da Next Defi.

Uma chave sem IP vinculado pode ter validade limitada. Além disso, qualquer pessoa que consiga a API Key e a API Secret poderá tentar utilizá-las. Por isso, o IP fixo é indispensável para uma integração segura.
IP DO SERVIDOR NEXT DEFI
167.233.209.88
É o mesmo IP das três corretoras. Cadastre exatamente este endereço, sem espaços.
07

Confirme a criação

A Bybit vai pedir as confirmações de segurança e então mostrar as duas chaves.

A API Secret aparece apenas no momento da criação. Copie e coloque diretamente no painel seguro do robô. Nunca envie por WhatsApp, Telegram, e-mail ou chat.
Código do Google Authenticator OBRIGATÓRIO
Código enviado por e-mail Se necessário. SE PEDIR
Confirmação de segurança OBRIGATÓRIO
A BYBIT MOSTRA
API KEY pode ser consultada depois
API SECRET aparece apenas uma vez
08

Conecte ao robô

No painel do robô, preencha os seis campos e clique em testar conexão.

PAINEL NEXT DEFI · CONECTAR BYBIT
CORRETORA Bybit
AMBIENTE Mainnet ou Real
TIPO DE CONTA Unified Trading Account
MERCADO Linear USDT Perpetual
API KEY chave fornecida
API SECRET chave secreta
O SISTEMA DEVE CONFIRMAR
Chave válida OK
Saldo localizado OK
Conta unificada reconhecida OK
Permissão de contratos ativa OK
Permissão para ordens ativa OK
Endereço IP autorizado OK
Testar conexão Verificar API Conectar Bybit
RESUMO · BYBIT

Configuração recomendada para a Next Defi

Confira este quadro ao final. Se algo estiver diferente, volte ao passo correspondente.

NOME
NEXT DEFI BOT
TIPO
Gerada pelo sistema
USO
Transações via API
MODO
Leitura e escrita
CONTRATOS · ORDENS
Ativado
CONTRATOS · POSIÇÕES
Ativado
SPOT
Desativado
CARTEIRA
Desativada
TRANSFERÊNCIAS
Desativadas
SAQUES
Desativados
RESTRIÇÃO DE IP
Ativada
IP
167.233.209.88
ANTES DO DINHEIRO REAL

Teste antes de usar dinheiro real

A Bybit oferece conta de demonstração com API. O ambiente demo utiliza endereços diferentes do ambiente real, crie uma chave exclusiva para ele.

Demo Trading da Bybit
1 Entre na conta principal
2 Mude para Demo Trading
3 Acesse Perfil → API
4 Crie uma chave exclusiva para demonstração
DIAGNÓSTICO · BYBIT

Os erros mais comuns

Clique para ver a causa e o que fazer.

10002 · horário fora de sincronização +
CAUSA

O relógio do servidor onde o robô roda está fora de sincronia com o horário da Bybit.

O QUE FAZER

Sincronize o relógio do servidor por NTP. Sua equipe técnica resolve isso na VPS.

10003 · chave inválida ou ambiente incorreto +
CAUSA

A chave foi digitada com erro, foi apagada, ou é uma chave de demonstração usada no ambiente real.

O QUE FAZER

Confirme a API Key e verifique se o ambiente do painel é Mainnet. Chave demo só funciona no ambiente demo.

10004 · assinatura incorreta +
CAUSA

A API Secret está incorreta, incompleta ou foi colada com caractere sobrando.

O QUE FAZER

Recrie a chave e informe a API Secret completa, sem espaços nem cortes.

10005 · permissão insuficiente +
CAUSA

A chave não tem leitura e escrita, ou as permissões de Ordens e Posições não foram marcadas.

O QUE FAZER

Volte ao passo 4 e 5: modo leitura e escrita, com Ordens e Posições ativadas em Contratos.

10010 · IP não autorizado +
CAUSA

O IP que está tentando acessar não está na lista de IPs informados da chave.

O QUE FAZER

Confira se o IP 167.233.209.88 está cadastrado na restrição de IP da chave, digitado exatamente assim.

OK
CORRETORA 3 DE 3
Como configurar a OKX
8 passos
Faça pelo computador. Na OKX você precisará guardar três informações, a Passphrase é uma senha criada por você no momento da configuração e não é a senha da sua conta OKX.
INFORMAÇÃO 1
API Key
pode ser consultada depois
INFORMAÇÃO 2
Secret Key
pode aparecer apenas na criação
INFORMAÇÃO 3
Passphrase
criada por você, não é recuperável
01

Prepare sua conta

Antes de criar a API, cumpra os cinco requisitos e defina o modo da conta na página de negociação.

Para operar contratos perpétuos em USDT, o Modo de Futuros costuma ser a opção mais simples. O modo Spot não permite ordens de contratos. Essa primeira configuração precisa ser feita no site ou aplicativo e não pode ser alterada inicialmente pela API.
Orientação oficial da OKX
Conclua a verificação de identidade
Ative o Google Authenticator
Ative as negociações de Futuros
Escolha o modo de conta Configurações → Modo da conta MODO DE FUTUROS
Defina o modo de posição utilizado pelo robô Veja o passo 8.
02

Acesse o menu de API

Entre no site oficial da OKX e siga o caminho abaixo. Depois clique em Criar chave API.

CAMINHO NO SITE
Perfil API Criar chave API
03

Preencha os dados

Configure a finalidade, a conta, o nome e crie a sua Passphrase.

A Passphrase deve ser forte e diferente da senha utilizada para entrar na OKX. Exemplo apenas de formato: NextBot@2026X, não utilize exatamente esse exemplo. Se a Next Defi ainda não aparecer entre os aplicativos autorizados da OKX, escolha Negociação por API e faça a conexão manual.
COMO PREENCHER
FINALIDADE Negociação por API
CONTA Conta principal
NOME NEXT DEFI BOT
PASSPHRASE crie uma senha exclusiva
04

Defina as permissões

Ative somente leitura e negociação. A permissão de negociação permite enviar, alterar, cancelar e fechar ordens.

O robô não precisa de permissão para sacar ou transferir dinheiro.
PERMISSÃOCONFIGURAÇÃO
Leitura Ativada
Negociação Ativada
Transferência Desativada
Saque Desativada
Empréstimos Desativada
Earn Desativada
05

Cadastre o endereço IP

No campo de restrição de IP, coloque o endereço do servidor da Next Defi. Todos os IPs precisam ser públicos e fixos.

A OKX informa que chaves com permissão de negociação ou saque, sem IP vinculado, são excluídas após 14 dias de inatividade.
Perguntas frequentes sobre API da OKX
IP DO SERVIDOR NEXT DEFI
167.233.209.88
É o mesmo IP das três corretoras. Cadastre exatamente este endereço, sem espaços.
06

Confirme a criação

A OKX poderá solicitar até quatro confirmações e então apresenta as três informações.

A Passphrase não poderá ser recuperada se for esquecida. A Secret Key também pode aparecer apenas no momento da criação. Nunca envie essas informações por WhatsApp, Telegram, e-mail ou chat.
Google Authenticator
Código de e-mail
Código do celular
Confirmação de segurança
07

Conecte ao robô

No painel do robô, preencha os oito campos e clique em testar conexão.

PAINEL NEXT DEFI · CONECTAR OKX
CORRETORA OKX
AMBIENTE Real ou Mainnet
MERCADO Perpetual Futures
TIPO DE INSTRUMENTO SWAP
MOEDA DE MARGEM USDT
API KEY chave fornecida pela OKX
SECRET KEY chave secreta
PASSPHRASE senha criada na API
Testar conexão Verificar API Conectar OKX
08

Confira o modo de posição

Na OKX, o robô e a conta precisam usar o mesmo modo de posição.

Se o robô trabalha com hedge, normalmente precisará do modo Long/Short. Se trabalha com somente uma direção por ativo, use o Modo líquido. Uma diferença entre o modo da conta e a configuração do robô pode causar rejeição das ordens.
MODOFUNCIONAMENTO
Modo líquido Uma posição única por ativo
Long/Short Compra e venda no mesmo ativo
RESUMO · OKX

Configuração recomendada para a Next Defi

Confira este quadro ao final. Se algo estiver diferente, volte ao passo correspondente.

NOME
NEXT DEFI BOT
FINALIDADE
Negociação por API
CONTA
Principal
LEITURA
Ativada
NEGOCIAÇÃO
Ativada
SAQUES
Desativados
TRANSFERÊNCIAS
Desativadas
EMPRÉSTIMOS
Desativados
EARN
Desativado
IP FIXO
167.233.209.88
MERCADO
SWAP
MARGEM
USDT
ANTES DO DINHEIRO REAL

Faça um teste em demonstração

A OKX permite criar uma API separada para negociação simulada. Não utilize a chave da conta real no ambiente demonstrativo.

1 Entre na OKX
2 Acesse Negociar
3 Selecione Negociação demonstrativa
4 Entre no perfil da conta demonstrativa
5 Clique em Criar chave API
6 Crie uma chave exclusiva para esse ambiente
DIAGNÓSTICO · OKX

Os problemas mais comuns

Clique para ver a causa e o que fazer.

Passphrase incorreta +
CAUSA

A Passphrase digitada no painel é diferente da que você criou na OKX, ou foi esquecida.

O QUE FAZER

A Passphrase não é recuperável. Crie uma nova chave API com uma Passphrase que você registre em lugar seguro.

IP não autorizado +
CAUSA

O IP que está tentando acessar não está na restrição de IP da chave.

O QUE FAZER

Confira se o IP 167.233.209.88 está cadastrado, digitado exatamente assim, sem espaços.

Permissão de negociação desativada +
CAUSA

A chave foi criada apenas com leitura, então o robô consulta mas não opera.

O QUE FAZER

Volte ao passo 4 e ative a permissão de Negociação, mantendo saques e transferências desativados.

Modo da conta incompatível +
CAUSA

A conta está no modo Spot, que não permite ordens de contratos.

O QUE FAZER

Em Configurações → Modo da conta, mude para o Modo de Futuros. Isso é feito no site ou aplicativo, não pela API.

Modo de posição diferente do robô +
CAUSA

A conta está em Modo líquido e o robô espera Long/Short, ou o contrário.

O QUE FAZER

Alinhe os dois conforme o passo 8. Enquanto divergirem, as ordens podem ser rejeitadas.

Conta demonstrativa no ambiente real +
CAUSA

Uma chave criada na negociação demonstrativa foi usada no ambiente real, ou o contrário.

O QUE FAZER

Cada ambiente tem chave própria. Crie uma chave exclusiva para o ambiente que você vai usar.

Horário do servidor fora de sincronização +
CAUSA

O relógio do servidor onde o robô roda está fora de sincronia com o horário da OKX.

O QUE FAZER

Sincronize o relógio do servidor por NTP. Sua equipe técnica resolve isso na VPS.

Assinatura da requisição inválida +
CAUSA

A Secret Key está incorreta, incompleta ou colada com caractere sobrando.

O QUE FAZER

Recrie a chave e informe a Secret Key completa, sem espaços nem cortes.

Senha da Binance

A Next Defi não deve receber nem armazenar a senha da sua conta na corretora, em nenhuma hipótese.

Código 2FA

O código do autenticador é só seu e muda a cada 30 segundos. Ninguém precisa dele além de você.

Frase de recuperação

Quem tem a frase tem a conta. Ela nunca deve ser digitada em painel, formulário ou mensagem.

Chave configurada. Agora é ligar a IA.

Com a API conectada e testada, você escolhe a estratégia disponível e acompanha as operações pelo painel.