Perguntas frequentes sobre a API da OKX

O que é a frase secreta?

A frase secreta é a senha que você preencheu ao solicitar a APIKey. Você precisa se lembrar dela. Uma vez esquecida, ela não pode ser recuperada e você vai precisar criar uma nova APIKey.

Como criar uma APIKey de disco simulado?

Para negociar na API de disco simulado, você precisa criar uma APIKey no disco simulado. Basta seguir os passos descritos abaixo:

Entre na sua conta da OKX > Trading > Trading simulado > Central pessoal > Criar APIKey da conta simulada > Começar a usar o trading simulado

A APIKey vai expirar?

APIKeys que não estão vinculadas a IP e têm permissões de transação ou saque serão excluídas automaticamente após 14 dias de inatividade. As APIKeys não serão consideradas inativas se forem usadas para ligar interfaces privadas ou relacionadas a contas que exigem verificação de identidade, como visualizar saldo da conta, dados de cobrança ou enviar ordens.

Somente APIKeys de leitura vinculadas a um IP ou permissões específicas não vencem.

Ordens criadas por meio da interface podem ser executadas em unidades de moeda?

Não, para ordens de contrato, o padrão da interface é ordens de número de contratos. Se precisar calcular a conversão entre o número de contratos e moedas, você pode consultar a interface de conversão entre contratos e moedas aqui.

Como obter a taxa de flutuação da interface?

A interface não informa diretamente o aumento ou a queda do preço, mas eles podem ser calculados por uma fórmula de cálculo.

O valor de aumento e queda do preço da última transação em comparação com o preço de abertura da linha K há 24 horas/100% do preço de abertura da linha K há 24 horas.

Os dados da fórmula acima podem ser obtidos por meio da interface do mercado aqui (últ. abertura 24h)/abertura 24h.

Qual é o motivo da mensagem de erro “Erro de 51000 do parâmetro posSide” ao criar uma ordem?

Você precisa verificar o modo de conta primeiro (modo de compra e venda/modo de abertura e fechamento) que pode ser visto aqui para obter o posMode.

Observação:

• No caso de abertura e fechamento de posições e criação de ordens usando um contrato, o parâmetro posSide é solicitado e a posição comprada ou vendida é executada.

• Se está no modo de compra e venda, ou uma transação de criptomoeda ou alavancagem é realizada no modo de abertura e fechamento, o posSide é compatível apenas com a transmissão líquida ou nenhuma transmissão.

Qual interface pode ser usada para obter o face value do contrato e a quantidade mínima de ordens?

Você pode usar a interface para encontrar informações básicas sobre produtos de trading aqui.

face value do contrato: ctVal, quantidade mínima da ordem: minSz.

Qual é o formato do instId?

Você pode usar a interface para encontrar informações básicas de produtos de trading aqui.

Como definir stop-loss e take-profit?

Se a ordem for anexada a take-profit stop-loss, você pode consultar a interface da ordem aqui: parâmetros da matriz attachAlgoOrds.

No entanto, se for uma ordem separada com stop-loss, você pode consultar a interface de comissão da estratégia aqui.

Por que um erro (51046, 51047, 51048, 51049) é relatado ao definir o preço de disparo para take-profit e stop-loss?

Regras para definir o preço de disparo stop-loss/take-profit: durante a venda, o preço de disparo take-profit é maior que o preço da transação mais recente e o preço de disparo stop-loss é menor que o preço da transação mais recente; durante a compra, o preço de disparo do take-profit é menor que o preço da transação mais recente e o preço de disparo de stop-loss é maior que o preço da transação mais recente.

O que é o “Erro de interface: 50102 solicitação de carimbo de data/hora expirada”?

Este erro ocorre quando o carimbo de data/hora expira. Você precisa sincronizar seu fuso horário com o do nosso servidor na interface de hora do sistema. A diferença de fuso deve ser de no máximo 30 segundos pode a evitar este problema.

Observação: o horário do cabeçalho da solicitação está no fuso UTC 0. O horário na interface do servidor está no fuso UTC+8.

O que é “Erro de interface: 50101 APIKey não corresponde ao ambiente atual”?

Isso ocorre devido à incompatibilidade entre a APIKey e o ambiente atual. As chamadas de conta real exigem o uso da APIKey da conta real, e o valor do parâmetro de trading simulado x no cabeçalho da solicitação precisa ser 0. As chamadas de conta simulada exigem o uso da APIKey da conta simulada, e o valor do parâmetro de trading simulado x no cabeçalho da solicitação precisa ser 1.

O que é “Erro de interface: 51010 Solicitação sem suporte no modo de conta atual”?

Esse erro está relacionado ao seu modo de conta. Se você deseja criar um contrato ou alavancagem com uma única moeda, é necessário ajustar para os outros modos que não o spot. Você pode configurá-lo nas configurações da interface aqui ou no site e no aplicativo.

Observação: a primeira configuração deve ser feita no site ou no aplicativo, nas configurações do menu principal da página de trading - Modo de conta.

O que é “Erro de interface: 51121 A quantidade da ordem deve ser um múltiplo do tamanho do lote”?

Na API, as ordens de contrato são em unidades de folhas e devem ser um múltiplo da quantidade mínima da ordem do par de moedas. A quantidade mínima da ordem pode ser obtida por meio do campo minSz da interface do produto aqui.

“Erro de saque: 58207 O endereço do saque não está na lista de permissão para isenção de verificação”. Por que a verificação da lista de permissão ainda relata um erro quando é fechada na página de saque?

Para sacar moedas usando a interface da API, é necessário adicionar o endereço do saque na página e verificar o não verificado pelo botão Visa. Se a verificação da lista de permissão for desativada na página, isso não afetará a função da interface.

O que é “Erro de interface: 50004 Tempo limite de solicitação do terminal da API” (não significa que a solicitação foi bem-sucedida ou falhou, verifique o resultado da solicitação)?

O erro 50004 geralmente é causado pela pressão excessiva do servidor. Todos os dias, às 8:00, 04:00 e 00:00 horas são cobradas as taxas de capital. Neste momento, a pressão do servidor é alta. Recomenda-se escalonar as transações nesses momentos. Se um erro 50004 for relatado em outros horários, você pode tentar novamente mais tarde. Se uma ordem for criada com um erro 50004, ela não vai representar o resultado real da solicitação da interface. A solicitação pode ser bem-sucedida ou falhar. Consulte o resultado real.

Observação: se você tiver alguma dúvida ou outras perguntas relacionadas à API, entre em contato conosco escaneando o código abaixo pelo aplicativo.

O que é o erro “50119 Chave de API não existe”?

Esse erro geralmente ocorre quando o domínio da sua conta não corresponde à sua região.

• Para usuários do EEE, mude o nome de domínio da solicitação de API para eea.okx.com em vez de www.okx.com.

• Para usuários dos EUA, mude o nome de domínio da solicitação de API para us.okx.com em vez de www.okx.com.

• Se você estiver usando um software de terceiros para se conectar à OKX e ver este erro, verifique com o provedor de software se ele é compatível com domínios regionais. Por exemplo, os usuários do EEE devem se conectar usando eea.okx.com. Caso contrário, a solicitação falhará.

Por que ele mostra o erro “50110” ao vincular a um software de terceiros?

Esse erro pode ocorrer se o tipo de chave de API atual não for compatível com a vinculação de software de terceiros. Tente solicitar o tipo de transação de chave de API, sem vincular uma lista de IP e, em seguida, reconectar o software de terceiros.