Perguntas Frequentes da API OKX
O que significa Passphrase?
Esta é a senha que você preencheu ao solicitar a chave de API. Você precisa lembrá-la por conta própria. Uma vez que você a esqueça, não poderá recuperá-la e precisará criar uma nova chave de API.
Como crio uma chave de API?
No App:
1. Faça login na sua Conta da OKX > Selecione Menu (⋮⋮⋮) > Role para baixo 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ão de endereços IP > Selecione as permissões > Insira a frase de segurança
Na Web:
1. Faça login na sua Conta da OKX > Vá para seu Perfil e selecione API e conexões > Criar chave de API
2. Preencha o nome da chave de API > Selecione conta e Usado para
3. Insira a lista de permissão de endereços IP > Selecione Permissões > Insira a Frase de segurança
Nota:
Endereços IP ajudam a proteger sua chave de API. Você pode vincular até 20 endereços por chave, separando-os por vírgula ou espaço.
Você precisa visualizar as informações da API e acessar sua interface. Por favor, mantenha sua senha segura. Você pode criar uma nova API se perder a senha, pois não podemos recuperar APIs.
Como faço para gerenciar ou editar a chave de API?
Para gerenciar ou editar sua chave de API na OKX:
Faça login na sua Conta da OKX e vá para Perfil > API.
Você verá uma lista das suas chaves API existentes. Clique na que deseja gerenciar.
A partir daqui, você pode:
Visualize o nome da chave de API, permissões e lista de IPs vinculados.
Edite o nome da chave, permissões (Leitura, Negociar, sacar) ou endereços IP vinculados.
Exclua a chave se ela não for mais necessária.
Nota: Você não pode visualizar a Frase Secreta após a criação inicial. Se perdê-la, será necessário excluir a chave existente e criar uma nova. Sempre armazene suas credenciais com segurança.
Como posso diferenciar entre spot ou trading com margem se eu negociar usando API?
A forma como o spot 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, entre em contato com o Assistente da OKX para orientação personalizada.
Como criar uma chave de API demo disk?
Para negociar na API do disco demo, você precisa criar uma chave de API no disco demo. Siga os passos abaixo:
Faça login na sua Conta da OKX > trading > trading simulado > Central Pessoal > Criar chave de API da Conta Demo > Comece o trading simulado
A chave de API vai expirar?
Chaves API que não estão vinculadas a IP e possuem permissões de transação ou saque serão automaticamente excluídas após 14 dias de inatividade. As chaves API não serão consideradas inativas se forem usadas para acessar interfaces privadas ou relacionadas à conta que exigem verificação de identidade, como visualizar saldo da conta, dados de faturamento ou realizar ordens.
Apenas as chaves de API somente leitura vinculadas a um IP ou permissões específicas não expirarão.
O que são as permissões de Empréstimo, Ganhar e Transferir?
Transferência: Permite que a chave transfira fundos entre suas contas. Disponível para todas as contas.
Empréstimo: Permite ao usuário pegar emprestado, pagar e gerenciar empréstimos. Visível apenas se sua conta tiver a elegibilidade necessária para o recurso.
Earn: Permite que a chave se inscreva e resgate produtos Earn. Visível apenas se sua conta tiver a elegibilidade necessária para o recurso.
Se sua Chave API anteriormente tinha permissões de Negociar ativadas, todas as três permissões serão ativadas automaticamente após esta atualização. Nenhuma configuração manual é necessária.
É possível fazer pedidos em unidades de moeda ao realizar ordens pela interface?
Não; para ordens de contrato, a interface padrão é para ordens em número de contratos. Se você 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 isso pode ser calculado por meio de uma fórmula de cálculo.
A variação percentual do valor do preço da última transação em relação ao preço de abertura da vela K de 24 horas atrás, dividida pelo preço de abertura da vela K de 24 horas atrás e multiplicada por 100%.
Os dados da fórmula acima podem ser obtidos através da interface de mercado aqui.
Qual é o motivo da mensagem de erro "51000 Parameter posSide error" ao colocar 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 posMode.
Nota:
No caso de abrir e fechar posições e fazer ordens usando um contrato, o parâmetro posSide é obrigatório, e deve ser preenchido com comprada ou posição vendida.
Se for um modo de compra e venda, ou uma transação de criptomoeda ou alavancada realizada no modo de abertura e fechamento, posSide suporta apenas líquido ou nenhuma transmissão.
Qual interface pode ser usada para obter o valor nominal do contrato e a quantidade mínima da ordem?
Você 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?
Você pode usar 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 vinculada a take-profit stop-loss, você pode consultar a interface de ordens aqui: parâmetros do array attachAlgoOrds.
No entanto, se for um stop-loss de ordem separada, você pode consultar a interface de comissão da estratégia aqui.
Por que um erro é reportado ao definir o preço de disparo para take-profit e stop-loss: 51046, 51047, 51048, 51049?
Regras para definir o preço de disparo do stop-loss/preço de disparo do take-profit – durante a venda, o preço de disparo do take-profit é maior que o preço da última transação, e o preço de disparo do stop-loss é menor que o preço da última transação; enquanto durante a compra, o preço de disparo do take-profit é menor que o preço da última transação, e o preço de disparo do stop-loss é maior que o preço da última transação.
O que significa "Erro de interface: 50102 Solicitação de timestamp vencida"?
Este erro ocorre quando o timestamp está vencido. Você precisa chamar a interface de tempo do sistema aqui para sincronizar seu horário local com o horário do nosso servidor. Manter a diferença de tempo dentro de 30 segundos pode ajudar a evitar esse problema.
Nota: o horário no cabeçalho da requisição está em UTC0. Ao chamar a interface de horário do servidor, o horário é fornecido em UTC + 8.
O que significa "Erro de interface: 50101 APIKey não corresponde ao ambiente atual"?
Isso ocorre devido à incompatibilidade entre a chave de API e o ambiente atual. Chamadas de 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 precisa ser 0. Chamadas de 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 precisa ser 1.
O que significa "Erro de interface: 51010 Solicitação não suportada no modo de conta atual"?
Isso está relacionado ao seu modo de conta. Se você quiser operar com alavancagem ou contrato de uma única moeda, precisa ajustar para um dos outros três modos, exceto o modo spot! Você pode configurá-lo através das configurações da interface aqui, ou pode configurá-lo no site ou no app.
Nota: a primeira configuração deve ser feita na página ou no app; 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, ordens de contrato são em unidades de contratos e devem ser múltiplos 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 de 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 apresenta um erro quando está desativada na página de saque?
Para sacar moedas usando a interface API, é necessário adicionar um endereço do saque na página e marcar o botão não verificado pelo Visa. Se a verificação da lista de permissão estiver desativada na página, isso não afetará a função da interface.
O que significa "Erro de interface: tempo limite de solicitação do terminal API 50004" (não significa que a solicitação foi bem-sucedida ou falhou, por favor, verifique o resultado da solicitação)?
O erro 50004 geralmente é causado por pressão excessiva no servidor. 8h, 16h e 24h são os horários para a cobrança de taxas de capital todos os dias. Nesses momentos, a pressão no servidor é alta. Recomenda-se escalonar as transações nesses horários. Se um erro 50004 for reportado em outros momentos, ele pode ser tentado novamente mais tarde. Se uma ordem for feita com erro 50004, isso não representa o resultado real da solicitação da interface. A solicitação pode ter sucesso ou falhar. Por favor, consulte o resultado real.
O que significa o erro "50119 API key não existe"?
Esse erro geralmente ocorre quando o domínio da sua conta não corresponde à sua região.
Para usuários da EEA, altere o nome do domínio da sua solicitação API para eea.okx.com em vez de www.okx.com.
Para usuários dos EUA, altere o nome do domínio da sua solicitação API para us.okx.com em vez de www.okx.com.
Se você estiver usando um software de terceiros para se conectar com a OKX e vir este erro, verifique com o fornecedor do software se ele suporta domínios regionais. Por exemplo, usuários da EEE devem se conectar através de eea.okx.com, caso contrário, a solicitação falhará.
Por que aparece o erro "50110" ao vincular a um software de terceiros?
Este erro pode ocorrer se o tipo atual da chave de API não for compatível com a vinculação de software de terceiros. Tente solicitar o tipo de transação da chave de API, sem vincular uma lista de IPs, e então reconecte o software de terceiros.
Como obtenho o preço da transação mais recente de um determinado par de moedas?
Use os detalhes aqui para tickers e para ticker, aqui. A interface de tickers é usada para obter o preço da última transação de pares de moedas em lotes, e ticker é usada para obter o preço da última transação de pares de moedas individuais.
Exemplo do parâmetro de resposta do último preço negociado na seção de Tickers
Quais são os requisitos para criar uma chave de API?
Um saldo mínimo de Ativos Sob Gestão (AUM) de 100 USD é necessário para criar uma chave de API.
É necessário um AUM maior que 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 é aplicável apenas a usuários em determinadas áreas
Nota:
Se você tiver dúvidas sobre WebSocket ou outros tópicos relacionados à API, clique no link do artigo e escaneie o código QR na parte inferior do artigo usando o App da OKX para entrar no grupo e entrar em contato com nosso especialista em suporte de API.
Como escanear: no app, toque em Menu > no ícone de código QR e escaneie o código QR.