Perguntas frequentes sobre a API OKX

A que se refere a frase de acesso?

Esta é a palavra-passe que introduziste ao solicitar a APIKey. Deves lembrar-te dela. Se te esqueceres, não poderás recuperá-la e terás de criar uma nova APIKey.

Como criar uma APIKey de disco de demonstração?

Para fazer trading na API do disco de demonstração, é necessário criar uma APIKey no disco de demonstração. Segue os passos abaixo:

Inicia sessão na tua conta OKX > Trading > Trading de demonstração > Centro pessoal > Criar APIKey de conta de demonstração > Iniciar trading de demonstração

A APIKey expira?

As APIKeys que não estão ligadas ao IP e têm permissões de transação ou levantamento serão automaticamente eliminadas após 14 dias de inatividade. As APIKeys não serão consideradas inativas se forem utilizadas para chamar interfaces privadas ou relacionadas com a conta que exijam verificação de identidade, como a visualização do saldo da conta, dados de faturação ou a realização de ordens.

Apenas as APIKeys só de leitura associadas a um IP ou a permissões específicas não expiram.

Pode ser criada uma ordem em unidades de moeda ao criar ordens através da interface?

Não; para ordens de contratos, a predefinição da plataforma são ordens em número de contratos. Se precisares de calcular a conversão entre o número de contratos e moedas, podes consultar a interface de conversão de número de contratos em moedas aqui.

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

A interface não pode obter diretamente o aumento ou a diminuição do preço, mas pode ser calculada através de uma fórmula de cálculo.

O valor de subida e descida 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 através da interface do mercado aqui (última-abertura24h)/abertura24h.

Qual é o motivo da mensagem de erro "Erro no parâmetro posSide 51000" ao colocar uma ordem?

Primeiro, deves verificar o modo de conta; modo de compra e venda/modo de abertura e fecho, que pode ser visualizado aqui, para obter o posMode.

Nota:

• No caso de abertura e fecho de posições e de colocação de ordens através de um contrato, é necessário o parâmetro posSide, e preenche-se long ou short.

• Se for um modo de compra e venda, ou se uma transação de criptomoeda ou alavancada for realizada no modo de abertura e fecho, o posSide apenas suporta transmissão líquida ou nenhuma transmissão.

Que interface pode ser utilizada para obter o face value do contrato e a quantidade mínima da ordem?

Podes utilizar a interface para obter informações básicas sobre produtos de trading aqui.

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

Qual é o formato de instId?

Podes utilizar a interface diretamente para obter as informações básicas dos produtos de trading aqui.

Como definir stop loss e take profit?

Se a ordem estiver anexada a take profit stop loss, podes consultar a interface da ordem aqui.: parâmetros de matriz attachAlgoOrds.

Contudo, se for uma ordem de stop loss separada, podes consultar a interface de comissão de estratégia aqui.

Porque é que é comunicado um erro quando se define o preço de desencadeamento para o take profit e o stop loss: 51046, 51047, 51048, 51049?

Regras para definir o preço de desencadeamento do stop-loss/take-profit - durante a venda, o preço de desencadeamento do take-profit é maior do que o último preço de transação e o preço de desencadeamento do stop-loss é menor do que o último preço de transação; enquanto durante a compra, o preço de desencadeamento do take-profit é menor do que o último preço de transação e o preço de desencadeamento do stop-loss é maior do que o último preço de transação.

O que significa "Erro de interface: 50102 Pedido de marcação de tempo expirado"?

Este erro ocorre quando a marcação de tempo expira. Deves ativar a interface de tempo do sistema aqui para sincronizar a tua hora local com a hora do nosso servidor. Manter a diferença horária dentro de 30 segundos pode ajudar a evitar este problema.

Nota: a hora no cabeçalho do pedido está em UTC0. Ao ligar-te à interface da hora do servidor, a hora é indicada em UTC + 8.

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

Isto deve-se à discrepância entre a APIKey e o ambiente atual. As chamadas de contas reais requerem o uso da APIKey da conta real, e o valor do parâmetro x-simulated-trading no cabeçalho do pedido deve ser 0. As chamadas de contas simuladas requerem o uso da APIKey da conta simulada, e o valor do parâmetro x-simulated-trading no cabeçalho do pedido deve ser 1.

O que significa “Erro de interface: 51010 Pedido não suportado no modo de conta atual”?

Isto está relacionado com o teu modo de conta. Se quiseres colocar uma alavancagem ou contrato de moeda única, deves ajustar para os outros três modos, à exceção do modo à vista! Podes defini-lo através das configurações da interface aqui, na web ou na aplicação.

Nota: a primeira configuração deve estar definida na página ou na aplicação; opção de configurações no menu principal da página de trading - Modo de conta.

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

Na API, as ordens de contrato estão em unidades de folhas e devem ser um múltiplo da quantidade mínima de ordem do par de moedas. É possível obter a quantidade mínima da ordem através do campo minSz da interface do produto aqui.

“Erro de levantamento: 58207 O endereço de levantamento não consta da lista de permissões para isenção de verificação”; porque é que a verificação da lista de permissões continua a indicar um erro quando é encerrada na página de levantamento?

Para levantar moedas utilizando a interface API, é necessário adicionar um endereço de levantamento na página e selecionar o botão “não verificado por visto”. O facto de a verificação da lista de permissões estar ou não desativada na página não afetará a função da interface.

O que significa "Erro de interface: 50004 tempo limite de pedido de ponto final de API" (não significa que o pedido foi bem-sucedido ou falhou, consulta o resultado do pedido)?

O erro 50004 é normalmente causado por uma pressão excessiva no servidor. 8, 16 e 24 horas são as horas de recolha diária das taxas de capital. Nesta altura, a pressão do servidor é elevada. Recomenda-se o escalonamento das transações nestas horas. Se for comunicado um erro 50004 noutros horários, é possível tentar novamente mais tarde. Se uma ordem for colocada com um erro 50004, este não representa o resultado efetivo do pedido de interface. O pedido pode ser bem-sucedido ou falhar. Consulta o resultado real.

Nota: caso tenhas outras dúvidas ou questões relacionadas com a API, podes contactar-nos ao ler o código abaixo através da aplicação.

O que é o erro "50119 a chave de API não existe"?

Normalmente, este erro ocorre quando o domínio da sua conta não corresponde à sua região.

• Para utilizadores do EEE, o nome de domínio do pedido de API deve ser alterado para eea.okx.com em vez de www.okx.com.

• Para utilizadores dos EUA, o nome de domínio do pedido de API deve ser alterado para us.okx.com em vez de www.okx.com.

• Se estiveres a utilizar um software de terceiros para aceder à OKX e vires este erro, verifica se o fornecedor de software suporta domínios regionais. Por exemplo, os utilizadores do EEE devem ligar-se através de eea.okx.com. Caso contrário, o pedido vai falhar.

Porque é que aparece o erro "50110" ao vincular a um software de terceiros?

Este erro pode ocorrer se o tipo de chave de API atual não for compatível com a associação a software de terceiros. Experimenta candidatar-te ao tipo de transação de chave de API, sem associar uma lista de IP e, em seguida, volta a vincular o software de terceiros.