Perguntas Frequentes
P1: Não é possível sacar fundos mesmo após adicionar o endereço à lista de permissões
Causas:
1. A lista de permissões na página de saque e a lista de permissões para saque via API são independentes uma da outra.
2. Endereços adicionados via [Página de Saque] > [Gerenciamento de Endereços de Saque] não são aplicáveis para saques via API.
Solução:
- Acesse a Página de Gerenciamento da Lista de Permissões para Saque via API: https://www.coinex.com/apikey
- Adicione o endereço de saque à lista de permissões específica para API.
P2: Erro access_id not exist
Causas Comuns:
(1) Chaves de API recém-criadas normalmente levam cerca de 10 minutos para se tornarem ativas. Chamar a API imediatamente após a criação pode acionar este erro.
(2) access_id incorreto.
(3) Verificação de assinatura inválida.
(4) Cabeçalho de solicitação incorreto.
Solução:
(1) Consulte a [Documentação da API CoinEx] para aprender como construir uma solicitação de autenticação HTTP.
(2) Demonstração:
P3: Erro 3008/4001 service unavailable
Causa: Este erro pode ocorrer ao cancelar ordens durante períodos de alta carga no servidor.
Solução:
(1) Priorize o cancelamento de ordens importantes.
(2) Tente novamente após 1-2 segundos.
(3) Se a resposta retornar code: 0, mas a ordem não for cancelada:
- Registre a solicitação e resposta completas.
- Entre em contato com o suporte ao cliente e forneça as informações da conta principal/subconta para assistência.
P4: Erro de Parâmetro Inválido
Causa: Isso geralmente ocorre quando os parâmetros enviados não correspondem aos tipos especificados na documentação da API.
Solução: Tomando o endpoint POST /spot/cancel-order como exemplo:
(1) Compare rigorosamente os nomes e tipos de parâmetros na documentação da API.
(2) Preste atenção especial às diferenças entre tipos numéricos e de string.
P5: Quais são os limites de taxa da API?
Os limites de taxa são divididos em limites de curto prazo e limites de longo prazo, que podem ser identificados através do Cabeçalho de Resposta:
1. Limites de Taxa de Curto Prazo: Se o valor X-RateLimit-Limit for maior que 0, o limite de taxa de curto prazo não foi acionado.
O limite de curto prazo usa um mecanismo de bucket de tokens, com limites de taxa independentes para contas principais e subcontas.
- Erro comum após o acionamento: Code: 213, 4213
- Mensagem: Please don't try too frequently.
2. Limites de Taxa de Longo Prazo: Se o X-RateLimit-LongPeriod-{period}-Remaining for retornado, os limites de taxa de longo prazo foram acionados. O sistema avalia o volume e a qualidade das solicitações do usuário para decidir se impõe limites ao total de solicitações por um período mais longo. Após o acionamento, as taxas de solicitação para todos os endpoints (exceto cancelamento de ordem) serão limitadas a 1 solicitação por segundo.
- Erro comum: Code: 213, 4213
- Julgamento adicional necessário via Cabeçalho de Resposta.
Outras Perguntas Comuns
P1: Como reduzir a latência das solicitações de API?
Os servidores estão implantados na AWS Tóquio e suportam balanceamento de carga entre regiões. Você pode escolher uma região próxima para minimizar a latência.
Zonas disponíveis:
- ap-northeast-1a
- ap-northeast-1c
- ap-northeast-1d
P2: É necessário 2FA para saques via API?
Por motivos de segurança:
1. Antes de usar saques via API, você deve fazer login e autorizar via 2FA.
2. Depois de adicionar endereços de saque à [Lista de Permissões para Saque], você pode iniciar saques via API sem verificação adicional de 2FA.
P3: Os endereços da lista de permissões para saque podem ser adicionados via API?
Atualmente, adicionar endereços à lista de permissões para saque via API não é suportado. Por favor, acesse [Gerenciamento de APIs] > [Lista de Permissões para Saque] para adicionar endereços manualmente ou em lote.
P4: Erro Signature incorrect
Soluções:
1. Verifique se o access_id e o secret_key estão configurados corretamente.
2. Verifique se o corpo da solicitação e os parâmetros usados para geração de assinatura são idênticos. Pré-processe os parâmetros da solicitação como strings e garanta consistência antes e depois da assinatura.
3. Se uma biblioteca de terceiros for usada para assinatura, certifique-se de que esteja configurada corretamente.
P5: Erro Tonce check error - Correct tonce should be within one minute of the current time
Solução:
(1) Certifique-se de que o timestamp para todas as solicitações de API esteja em milissegundos.
Exemplo:
(2) Verifique se o seu computador tem a sincronização automática de horário ativada.
P6: Como recuperar o saldo disponível real e o valor líquido de uma conta de futuros?
(1) Use o endpoint /assets/futures/balance para recuperar o campo available, que indica o saldo disponível atual da conta de futuros.
(2) Os endpoints da API atualmente não suportam retornar o valor líquido da conta. O valor líquido é a soma dos lucros e perdas realizados e não realizados.
(3) Lucros e perdas não realizados não são valores fixos e podem flutuar com mudanças de posição. Cálculos manuais são necessários para resultados precisos.
(4) Para fórmulas de cálculo, consulte a documentação "Como Calcular o Rendimento da Conta e PNL de Contrato Linear".
P7: Como processar dados retornados pela API WebSocket?
A API WebSocket retorna dados em formato de string JSON compactada, que deve ser descompactada antes do uso (por exemplo, usando o módulo gzip).
Erro Comum:
utf-8 codec can't decode byte 0x8b in position 1: invalid start byte
P8: O que fazer se uma plataforma de impostos de terceiros relatar um erro?
Os serviços V1 foram descontinuados em 25-09-2024. O erro pode ser devido à plataforma não atualizar seu código para V2. Entre em contato com a plataforma de impostos relevante para obter assistência.
P9: Como confirmar uma conexão WebSocket bem-sucedida?
Após uma assinatura bem-sucedida, uma resposta de resultado de assinatura será recebida.
Posteriormente, você receberá as atualizações de mensagens assinadas:
P10: Por que a conexão WebSocket se desconecta automaticamente? Como manter a conexão?
(1) Desconexões WebSocket geralmente são causadas por problemas de rede. Verifique se a conexão de rede está estável.
(2) Para manter a conexão WebSocket, você precisa usar server.ping para mantê-la ativa.
(3) Se não houver comunicação com o servidor por 1 minuto, a conexão WebSocket será automaticamente desconectada. Recomenda-se definir um intervalo de envio dentro de 60 segundos via interface ping para manter a conexão ativa.
Para outros erros de API, por favor clique AQUI para entrar em contato com o suporte ao cliente e forneça as seguintes informações para ajudar a resolver o problema:
(1) O e-mail da conta principal ou o nome de usuário da subconta.
(2) Detalhes completos da solicitação e resposta.
Importante: NÃO compartilhe o access_id e o secret_key nas mensagens de erro para evitar perdas desnecessárias.