Perguntas frequentes sobre a API OKX

A que se refere a frase de acesso?

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

Como posso criar uma chave de API?

Na aplicação:

1. Inicia sessão na tua conta OKX > seleciona Menu > Desloca-te para baixo e seleciona API > Criar chave de API

2. Preenche o nome da API > seleciona Conta e Propósito > introduz a lista de permissões de endereços IP > seleciona Permissões > introduzi a frase de recuperação

No site:

1. Inicia sessão na tua conta OKX > Vai ao teu perfil e seleciona API e ligações > Criar chave de API

2. Preenche o nome da chave de API > Seleciona Conta e Usada para

3. Introduz a lista de permissões de endereços IP > Seleciona Permissões > Introduz a frase de recuperação

Nota:

• Os endereços IP ajudam a proteger a chave de API. Podes associar até 20 endereços por chave, separando-os com vírgulas ou espaços.

• Tens de ver as informações da API e aceder à respetiva interface. Certifica-te de que manténs a tua palavra-passe em segurança. Se perder a palavra-passe, pode criar uma nova API, uma vez que não é possível recuperar as API.

Como criar uma chave de API de disco de demonstração?

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

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

A chave de API expira?

As chaves de API 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 chaves de API 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 chave de APIs 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.

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 chave de API e o ambiente atual. As chamadas de contas reais requerem o uso da chave de API 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 chave de API 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.

Como posso obter o último preço de transação de um determinado par de moedas?

Usa os detalhes aqui para os tickers e para o ticker, acima de aqui. A interface de tickers é utilizada para obter o preço de transação mais recente de pares de moedas em lotes, e o ticker é utilizado para obter o preço de transação mais recente de pares de moedas individuais.

Exemplo do parâmetro de resposta do último preço transacionado na secção Tickers