Perguntas frequentes da API OKX
A que se refere a Frase-Passe?
Esta é a palavra-passe que preencheu ao solicitar a chave de API. Precisa de a memorizar. Se a esquecer, não poderá recuperá-la e terá de criar uma nova chave de API.
Como crio uma chave de API?
Na App:
1. Inicie sessão na sua Conta OKX > Selecione Menu (⋮⋮⋮) > Desça e selecione API > Criar chave de API
2. Preencha o nome da API > Selecione a conta e o propósito > Insira a lista de permissões de endereços IP > Selecione as permissões > Insira a frase de segurança
Na Web:
1. Inicie sessão na sua Conta OKX > Vá ao seu Perfil e selecione API e ligações > Criar chave de API
2. Preencha o nome da chave de API > Selecione Conta e Utilizado para
3. Introduza a lista de permissões de endereços IP > Selecione Permissões > Introduza a Frase de segurança
Nota:
Os endereços IP ajudam a proteger a sua chave de API. Pode associar até 20 endereços por chave, separando-os por vírgula ou espaço.
É necessário visualizar as informações da API e aceder à sua interface. Por favor, mantenha a sua palavra-passe segura. Pode criar uma nova API se perder a palavra-passe, pois não podemos recuperar APIs.
Como posso gerir ou editar a chave de API?
Para gerir ou editar a sua chave de API na OKX:
Inicie sessão na sua Conta OKX e vá a Perfil > API.
Verá uma lista das suas chaves API existentes. Clique naquela que deseja gerir.
A partir daqui, pode:
Visualizar o nome da chave de API, permissões e lista branca de IPs vinculados.
Edite o nome da chave, permissões (Ler, Trading, Levantar) ou endereços IP vinculados.
Eliminar a chave se já não for necessária.
Nota: Não pode visualizar a Frase-Passe após a criação inicial. Se a perder, terá de eliminar a chave existente e criar uma nova. Guarde sempre as suas credenciais de forma segura.
Como posso diferenciar entre trading à vista ou trading com margem se eu negociar usando API?
A forma como o trading à vista e o trading com margem são diferenciados via API pode variar dependendo do seu tipo de conta e configurações. Recomendamos consultar a documentação da API OKX para obter os parâmetros mais precisos e atualizados aplicáveis à configuração da sua conta.
Se precisar de mais esclarecimentos, contacte o OKX Assistant para obter orientação personalizada.
Como criar uma chave de API para disco de demonstração?
Para realizar uma transação na API do disco de demonstração, precisa criar uma chave de API no disco de demonstração. Siga os passos abaixo:
Inicie sessão na sua Conta OKX > Trading > trading de demonstração > Centro Pessoal > Criar chave de API da Conta de Demonstração > Começar trading de demonstração
A chave de API irá expirar?
As chaves API que não estão vinculadas a IP e que têm permissões de transação ou levantamento serão automaticamente eliminadas após 14 dias de inatividade. As chaves API não serão consideradas inativas se forem usadas para chamar interfaces privadas ou relacionadas à conta que exigem verificação de identidade, como visualizar o saldo da conta, dados de faturação ou realizar ordens.
Apenas as chaves API de leitura que estejam vinculadas a um IP ou a permissões específicas não expirarão.
Quais são as permissões de Empréstimo, ganhar e transferir?
Transferir: Permite a chave transferir fundos entre as suas contas. Disponível para todas as contas.
Empréstimo: Permite ao titular pedir empréstimo, amortizar e gerir empréstimos. Apenas visível se a sua conta tiver a elegibilidade necessária para esta funcionalidade.
Ganhar: Permite que a chave subscreva e resgate produtos Ganhar. Visível apenas se a sua conta tiver a elegibilidade necessária para esta funcionalidade.
Se a sua Chave API tinha anteriormente permissões de Trading ativadas, as três permissões serão automaticamente ativadas com esta atualização. Não é necessário configurar manualmente.
É possível fazer ordens em unidades de moeda ao colocar ordens através da interface?
Não; para ordens de contratos, a interface define por padrão ordens em número de contratos. Se precisar calcular a conversão entre o número de contratos e moedas, pode consultar a interface de conversão de contratos para moedas aqui.
Como obter a taxa de flutuação da interface?
A interface não pode obter diretamente o aumento ou 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 comparado 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 de mercado aqui.
Qual é a razão da mensagem de erro "51000 Parameter posSide error" ao colocar uma ordem?
É necessário verificar primeiro o modo de conta; modo de compra e venda/modo de abertura e fecho, que pode ser consultado aqui para obter posMode.
Nota:
No caso de abrir e fechar posições e colocar ordens usando um contrato, o parâmetro posSide é obrigatório, e deve ser preenchido com longa ou curta.
Se for um modo de compra e venda, ou uma transação de criptomoeda ou alavancada for realizada no modo de abertura e encerramento, posSide só suporta líquido ou sem transmissão.
Qual interface pode ser usada para obter o valor nominal do contrato e a quantidade mínima da ordem?
Pode usar a interface para obter informações básicas dos produtos de trading aqui.
valor nominal do contrato: ctVal, quantidade mínima da ordem: minSz.
Qual é o formato do instId?
Pode utilizar diretamente a interface para obter as informações básicas dos produtos de trading aqui.
Como definir stop loss e take profit?
Se a ordem estiver associada a take profit stop loss, pode consultar a interface de ordens aqui: parâmetros do array attachAlgoOrds.
No entanto, se for um stop loss de ordem separado, pode consultar a interface de comissão da estratégia aqui.
Por que é reportado um erro ao definir o preço de desencadeamento para take profit e stop loss: 51046, 51047, 51048, 51049?
Regras para definir o preço de desencadeamento de stop-loss/preço de desencadeamento de take-profit – durante a venda, o preço de desencadeamento de take-profit é superior ao preço da última transação, e o preço de desencadeamento de stop-loss é inferior ao preço da última transação; enquanto durante a compra, o preço de desencadeamento de take-profit é inferior ao preço da última transação, e o preço de desencadeamento de stop-loss é superior ao preço da última transação.
O que significa "Erro de interface: 50102 Pedido de timestamp expirado"?
Este erro ocorre quando o carimbo de data/hora expirou. É necessário chamar a interface de tempo do sistema para sincronizar a sua hora local com a hora do nosso servidor. Manter a diferença de tempo dentro de 30 segundos pode ajudar a evitar este problema.
Nota: a hora no cabeçalho do pedido está em UTC0. Ao chamar a interface de hora 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 chave de API e o ambiente atual. As chamadas para conta real exigem o uso da chave de API da conta real, e o valor do parâmetro x-simulated-trading no cabeçalho da requisição deve ser 0. As chamadas para conta simulada exigem o uso da chave de API da conta simulada, e o valor do parâmetro x-simulated-trading no cabeçalho da requisição 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 quiser colocar alavancagem ou contrato numa única moeda, precisa de ajustar para um dos outros três modos, exceto o modo à vista! Pode configurá-lo através das definições da interface aqui, ou pode configurá-lo na web ou na app.
Nota: a primeira configuração deve ser 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 contratos e devem ser múltiplas da quantidade mínima de ordem do par de moedas. A quantidade mínima de ordem pode ser obtida através do campo minSz da interface do produto aqui.
"Erro de levantamento: 58207 O endereço do levantamento não está na lista de permissões para isenção de verificação"; por que a verificação da lista de permissões ainda reporta um erro quando está desativada na página de levantamento?
Para levantar moedas usando a interface API, é necessário adicionar um endereço do levantamento na página e assinalar o botão "não verificado pelo Visa". Se a verificação da lista de permissões estiver desativada na página, isso não afetará a função da interface.
O que significa "Erro de interface: 50004 tempo limite de pedido do ponto final da API" (não significa que o pedido foi bem-sucedido ou falhou, por favor verifique o resultado do pedido)?
O erro 50004 é geralmente causado por pressão excessiva no servidor. Os horários das 8, 16 e 24 horas são os pontos de recolha das taxas de capital todos os dias. Nestes momentos, a pressão no servidor é elevada. Recomenda-se escalonar as transações nestes horários. Se um erro 50004 for reportado em outros momentos, pode ser tentado novamente mais tarde. Se uma ordem for colocada com um erro 50004, isso não representa o resultado real do pedido da interface. O pedido pode ter sucesso ou falhar. Por favor, consulte o resultado real.
O que significa o erro "50119 API key não existe"?
Este erro geralmente ocorre quando o domínio da sua conta não corresponde à sua região.
Para utilizadores da EEE, por favor altere o nome de domínio do seu pedido API para eea.okx.com em vez de www.okx.com.
Para utilizadores dos EUA, por favor altere o nome de domínio do seu pedido API para us.okx.com em vez de www.okx.com.
Se estiver a usar um software de terceiros para se ligar à OKX e vir este erro, por favor verifique com o fornecedor do software se suporta domínios regionais. Por exemplo, os utilizadores da EEE devem ligar-se através de eea.okx.com, caso contrário o pedido falhará.
Por que aparece o erro "50110" ao ligar a um software de terceiros?
Este erro pode ocorrer se o tipo atual de chave de API não for compatível com a ligação de software de terceiros. Tente solicitar o tipo de transação da chave de API, sem vincular uma lista de IP, e depois reconecte o software de terceiros.
Como posso obter o preço da transação mais recente de um determinado par de moedas?
Use os detalhes aqui para os símbolos ticker e para o símbolo ticker, mais aqui. A interface de símbolos ticker é usada para obter o preço da última transação de pares de moedas em lotes, e o símbolo ticker é usado para obter o preço da última transação de pares de moedas individuais.
Exemplo do parâmetro de resposta do último preço transacionado na secção de Tickers
Quais são os requisitos para criar uma chave de API?
É necessário um saldo mínimo de 100 USD em Ativos Sob Gestão (AUM) para criar uma chave de API.
É necessário um AUM superior a 100 USD (AUM > 100U) para criar uma chave de API
Para contas master ou subcontas, apenas contas com AUM > 100U podem criar chaves API
Nota: Este requisito aplica-se apenas a utilizadores em determinadas áreas
Nota:
Se tiver dúvidas sobre WebSocket ou outros temas relacionados com API, clique no link do artigo e escaneie o QR code no final do artigo usando a aplicação da OKX para entrar no grupo e contactar o nosso especialista de suporte API.
Como escanear: na app, toque em Menu > no ícone de Scan e escaneie o QR code.