Nem todos os produtos mencionados estão disponíveis em todas as jurisdições.

Perguntas Frequentes sobre a API OKX

Publicado a 20/09/2024Atualizado a 1/11/2024Leitura de 8 minutos4

A que se refere a frase de acesso?

Esta é a palavra-passe que introduziu ao solicitar a APIKey. Deve lembrar-se dela. Se se esquecer dela, não a poderá recuperar e terá de criar uma nova APIKey.

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

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

Inicie sessão na sua conta OKX > Trading > Trading de demonstração > Centro pessoal > Criar conta APIKey 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.

As ordens podem ser colocadas em USDT ou unidades monetárias ao serem colocadas através da interface?

Não; para as ordens de contrato, a interface utiliza as ordens em número de contratos como predefinição. Se precisar de calcular a conversão entre o número de contratos e moedas, pode 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 efetuar uma ordem?

Em primeiro lugar, é necessário verificar o modo da conta; modo de compra e venda/modo de abertura e fecho, que pode ser consultado aqui para obter 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 sem transmissão.

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

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

valor nominal do contrato: ctVal, quantidade mínima de ordem: minSz.

Qual é o formato de instId?

Pode utilizar diretamente a interface para obter as informações básicas sobre os produtos de trading aqui.

Exemplo de formato instId:

Alavancagem de moeda/moeda: BTC-USDT

Contrato perpétuo: Padrão da moeda: BTC-USD-SWAP, padrão U: BTC-USDT-SWAP Todas as letras devem ser maiúsculas

Contrato de liquidação: padrão da moeda: BTC-USD-210326, padrão U: BTC-USDT-210326 últimos dois dígitos do ano + semana em curso ou semana seguinte ou mês em curso ou mês seguinte ou trimestre em curso ou trimestre seguinte

Contratos de opções: Opções bullish BTC-USD-210326-2000-C, opções de venda BTC-USD-210326-2000-P

Como definir stop loss e take profit?

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

No entanto, se se tratar de uma ordem stop loss separada, pode consultar a interface de comissão de estratégia aqui.

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

Regras para definir o preço de ativação do stop-loss/take-profit - durante a venda, o preço de ativação do take-profit é maior do que o último preço de transação e o preço de ativação do stop-loss é menor do que o último preço de transação; enquanto durante a compra, o preço de ativação do take-profit é menor do que o último preço de transação e o preço de ativação 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. Deve ativar aqui a interface de tempo do sistema para sincronizar a sua 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 na hora do cabeçalho do pedido está em UTC0. Ao ativar a interface de tempo do servidor, a hora é fornecida em UTC + 8.

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

Isto deve-se à incompatibilidade entre a APIKey e o ambiente atual. As chamadas de conta real requerem a utilização da APIKey da conta real e o valor do parâmetro x- trading-simulado no cabeçalho do pedido deve ser 0. As chamadas de conta simulada requerem a utilização da APIKey da conta simulada e o valor do parâmetro x- trading-simulado 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 seu modo de conta. Se pretender colocar uma alavancagem ou contrato de moeda única, deve ajustar para os outros três modos, exceto para o modo à vista! Pode defini-lo através das definições da interface aqui, ou pode defini-lo no site ou na aplicação.

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

O que significa “Erro de interface: 51121 A quantidade da encomenda 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 50004" (não significa que o pedido foi bem sucedido ou falhou, consulte 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 noutras alturas, é possível tentar novamente mais tarde. Se uma ordem for colocada com um erro 50004, não representa o resultado efetivo do pedido de interface. O pedido pode ser bem sucedido ou falhar. Consulte o resultado real.

Nota: se tiver quaisquer outras perguntas ou questões relacionadas com a API, pode contactar-nos digitalizando o código abaixo através da aplicação.

okxapi-app-1