O que é preciso observar ao conectar a API de uma bolsa

Conceda apenas as permissões necessárias

O modo de conta pessoal exige permissões de leitura e trading. Os nomes das permissões variam conforme a exchange; após a vinculação, o resultado da verificação de permissões da Oqiron deve ser considerado. A permissão de saque não bloqueia a vinculação da API nem a inicialização do bot, e a OQIRON não usa a API de trading do cliente para realizar saques.

Proteja as credenciais da API

Nem a página do cliente nem a página de gerenciamento do Oqiron devem exibir a chave completa. A troca da API não deve excluir os registros históricos de ordens e ganhos já existentes.

• Não envie o Segredo da API e a Senha por aplicativos de bate-papo, e-mail ou capturas de tela
• Não armazene credenciais completas em documentos públicos, notas na nuvem ou repositórios de código
• Ao detectar vazamentos, logins anormais ou transações desconhecidas, revogue imediatamente a API antiga na bolsa e, em seguida, entre em contato com o suporte da plataforma

Vincular não significa ativar

Após a criação bem-sucedida da API, o sistema ainda verificará a atribuição de identidade, a capacidade de leitura, as permissões de negociação, o modo de posição e outras condições de ativação. Caso algum dado essencial não possa ser confirmado, o robô permanecerá inativo.

Escopo de suporte e troca de API

A página do cliente oferece atualmente pontos de conexão para OKX, Binance, Bybit, Gate e Bitget; no entanto, a possibilidade de cada bolsa ser utilizada para operações reais deve ser verificada com base nos resultados da verificação efetiva da conta. Antes de substituir ou excluir uma API, é necessário interromper com segurança os robôs relacionados; após a nova API ser aprovada na verificação, os registros históricos de ordens e ganhos devem ser mantidos.

A API é como uma chave exclusiva: quanto menos permissões, mais segura ela é

A API permite que o sistema leia a conta e execute transações sem que o cliente precise fornecer a senha da bolsa. Ao criá-la, utilize a API exclusiva para o Oqiron, que não deve ser compartilhada com outros robôs, e configure restrições de IP de acordo com o que for permitido pela bolsa. Permissões além da leitura e da execução de transações não devem ser concedidas antecipadamente com o argumento de que “poderão ser necessárias no futuro”.

Após o vazamento da chave, a simples exclusão da vinculação na página do Oqiron não invalida a chave antiga; é necessário retornar à corretora para revogá-la. Após a recriação, o sistema precisa verificar novamente a capacidade de leitura, as permissões do contrato, o modo de conta e o modo de posição; não se deve interpretar “Salvo com sucesso” como “Verificação aprovada”.

Após a leitura, o cliente deverá ser capaz de:

Compreender verdadeiramente um artigo informativo não significa apenas memorizar alguns termos, mas sim ser capaz de tomar decisões corretas ao analisar as páginas reais e o status da conta. A lista a seguir pode ser usada para verificar se você já dominou os pontos-chave.

• Utilize uma API independente, sem compartilhamento com outros serviços
• Ative apenas as permissões de leitura e as necessárias para a negociação
• Desative sempre as permissões de saque e transferência de fundos
• Antes de fazer qualquer alteração, desative o robô com segurança; em caso de vazamento, cancele primeiro a transação na bolsa.

Perguntas frequentes dos clientes

Essas questões estão diretamente relacionadas ao conteúdo deste artigo. As respostas seguem as regras atuais da plataforma e os parâmetros de operação reais; quando se tratar de pacotes, proporções, escopo de funcionalidades ou status da conta, prevalecerão as informações da página do cliente e das faturas oficiais.

• Quais permissões a API da exchange exige? | Contas pessoais precisam de permissões de leitura e trading; após a vinculação, use a verificação de permissões da Oqiron para confirmar os nomes exatos. A permissão de saque não bloqueia a vinculação da API nem a inicialização do bot, e a OQIRON não usa a API de trading do cliente para realizar saques.
• O atendimento ao cliente vai me pedir o segredo da API ou a frase mnemônica? | Não. Não envie o segredo da API, a frase de senha, a chave privada, a frase mnemônica ou a senha por meio do atendimento online, do Telegram, do WhatsApp ou de outros aplicativos de bate-papo.
• A troca da API causará perda do histórico? | Não deveria. Antes da troca, desative com segurança os robôs relacionados; a nova API precisa ser verificada novamente. As ordens existentes, as posições em aberto e o histórico de ganhos devem ser mantidos de acordo com a atribuição a cada cliente e robô, sem depender da chave antiga para continuar existindo.