Anúncio de Atualização da API de Margem da KuCoin

Anúncio de Atualização da API de Margem da KuCoin

04/07/2025, 06:33:02

Personalizado

Caros usuários da KuCoin,

Para fornecer aos usuários um ambiente de negociação melhor e otimizar a experiência de negociação, a API de Alavancagem da KuCoin está passando por uma migração e atualização de alta frequência. Essa migração será realizada em vários lotes e deverá ser concluída até o final de março de 2026.

1. Alcance da Migração:

Para usuários que ativaram a margem, se não houver posições ou ativos de margem durante a migração, isso não o afetará.

2. Impacto da Migração:

     2.1 Usuários não-API (usuários finais)

  • A experiência do usuário na Web/App permanecerá inalterada antes e depois da migração.

     2.2 Usuários da API

  • Esta migração terá um certo impacto no método de chamada da interface da API e na exibição do status dos ativos. Esta migração será notificada em lotes. Por favor, realize as operações correspondentes a tempo após receber a notificação por e-mail. O sistema realizará a migração 7 dias após o envio do e-mail. (Para reduzir o impacto, você pode alternar para a API de alta frequência antecipadamente.)

3. Processo de migração:

Etapa 1: Limpeza manual de ordens de baixa frequência

a. Os usuários precisam cancelar as ordens colocadas por API de baixa frequência e C-end (Web/App) por conta própria;

b. As ordens de alta frequência não precisam ser canceladas;

  • Se você não cancelar ativamente, o sistema cancelará automaticamente o pedido durante o processo de migração (incluindo ordens normais e avançadas).

  • Se você não confirmar o status do seu pedido, entre em contato com o serviço de atendimento ao cliente para consulta.

Etapa 2: Transferir manualmente ativos de baixa frequência (usuários de API)

a. Os usuários precisam transferir manualmente os ativos da conta de baixa frequência para contas de alta frequência e migrar para a nova interface de API (consulte o api-doc para mais detalhes).

b. Obter Cotas de Transferência - KUCOIN API Neste momento, os ativos no lado C (Web e App) são exibidos como "BLOQUEADOS", e ordens de alta frequência não podem ser operadas.

Etapa 3: Iniciar a migração

As etapas 1 e 2 não são obrigatórias, mas, uma vez executada a migração, o sistema cancelará automaticamente as ordens de baixa frequência e transferirá os ativos de baixa frequência para contas de alta frequência.

Observações importantes:

  1. Disponibilidade temporária da conta (usuários do lado C e usuários de API serão afetados);

Durante a execução da migração, as contas dos usuários estarão temporariamente indisponíveis por 2-3 minutos, envolvendo as funções de consulta de ativos, negociação e transferência. Por favor, organize suas operações com antecedência para evitar impactar suas transações.

  1. Cancelamento forçado de ordens de baixa frequência;

Se o usuário não cancelar a ordem de baixa frequência com antecedência, o sistema cancelará automaticamente as ordens ordinárias e avançadas de baixa frequência não realizadas durante o processo de migração.

  1. Os ativos são exibidos como "congelados" por um curto período;

Durante a fase de preparação da migração, ativos de alta frequência podem ser exibidos como "congelados" na interface antiga e retornarão ao normal após a conclusão da migração.

  1. Dicas de compatibilidade da interface;

A antiga interface não dará mais suporte a consultas relacionadas à conta de alta frequência. Certifique-se de concluir a migração antecipadamente, caso contrário, uma exceção poderá ser retornada.

  1. A migração oficial ocorrerá 7 dias após a notificação por e-mail;

A migração oficial começará 7 dias após o envio da notificação por e-mail. Recomenda-se aos usuários que monitorem atentamente suas caixas de entrada e completem todos os preparativos necessários antes da data da migração para garantir uma transição suave e evitar interrupções no serviço.

Conteúdo detalhado da migração:

Consultas de ativos

  •  Recomendamos o uso da nova interface da API para consultas de ativos:

    • Consulta de ativos da conta de margem cruzada: /api/v3/margin/accounts

    • Consulta de ativos da conta de margem isolada: /api/v3/isolated/accounts

  •  Após a migração, os dados de ativos antes e depois da migração permanecerão consistentes. Uma vez concluída a migração, todas as consultas de margin, margin_v2 e ALL retornarão resultados consistentes (da mesma forma para contas isoladas).

Observação: As interfaces antigas de consulta de ativos (/api/v1/margin/account para margem cruzada e /v1/isolated/accounts para margem isolada) permanecerão disponíveis após a migração, mas os ativos de alta frequência serão exibidos como "Congelados" para usuários que ainda não migraram.

Consultas do Registro de Transações

1. Interface V1: /api/v1/accounts/ledgers

  • O livro-razão pode ser consultado para contas de alta e baixa frequência antes e depois da migração, com o mesmo intervalo de tempo anterior.

2. Interface V3: /api/v3/hf/margin/account/ledgers

  • Isso suporta apenas a consulta de transações de conta de alta frequência, com um intervalo de tempo limitado aos últimos três dias.

Os usuários podem escolher a interface de acordo com suas necessidades.

Transferências

  •  A interface de transferência permanece a mesma. A interface anterior ainda pode ser usada para transferências entre contas de alta e baixa frequência.

    • Antes da migração: são suportadas transferências entre contas de alta e baixa frequência dentro do mesmo usuário.

    • Após a migração: margin e margin_v2 serão tratados como a mesma conta, e as transferências entre essas duas contas não serão mais suportadas (da mesma forma para a margem isolada).

Consultas de Ordens Históricas

1. Interface V1: /api/v1/orders?status=done

  • Os pedidos históricos podem ser consultados para pedidos de alta e baixa frequência, com o mesmo intervalo de tempo.

2. Interface V3: /api/v3/hf/margin/orders/done

  • Isso suporta apenas a consulta de ordens de alta frequência e pode retornar dados apenas dos últimos três dias. Os usuários podem escolher conforme suas necessidades.

Colocação de Ordem / Cancelamento de Ordem / Consulta de Ordem Ativa

1. Interface V1: Suporta a colocação, cancelamento e consulta de ordens ativas de baixa frequência.

2. Interface V3: Suporta a colocação, cancelamento e consulta de ordens de alta frequência ativas.

Ordens de alta e baixa frequência não são compatíveis entre si, incluindo funções de take-profit e stop-loss. Os usuários devem usar a interface correspondente com base no tipo de ordem.

Alterações na Interface de Migração:

  • Observação: Recomenda-se esclarecer as alterações na interface envolvidas antes e depois da migração com antecedência para evitar impactos no uso.

Ação

Antes da Interface de Migração

Após a Interface de Migração

Colocação de ordem

Ordem Regular: /api/v1/margin/order

Ordem de parada: /api/v1/stop-order

Ordem Regular: /api/v3/hf/margin/order Ordem de parada: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

Cancelamento de Ordem

Por ID do pedido: /api/v1/orders/{orderId}

Por clientOid: /api/v1/order/client-order/{clientOid}

Cancelamento em massa: /api/v1/orders

Por orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

Por clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

Cancelamento em massa: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

Consulta de Ordem Ativa

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Consultar pares de negociação ativos: /api/v3/hf/margin/order/active/symbols


Aviso de Risco

A negociação de margem refere-se à prática de emprestar fundos com uma quantia relativamente menor de capital para negociar ativos financeiros e obter lucros maiores. No entanto, devido a riscos de mercado, flutuações de preços e outros fatores, recomenda-se fortemente que você seja prudente em suas ações de investimento, adote um nível adequado de alavancagem para a negociação de margem e encerre seus prejuízos oportunamente. KuCoin não assume nenhuma responsabilidade por quaisquer perdas decorrentes da negociação.

Obrigado pelo seu apoio!

A equipe KuCoin

Encontre a próxima joia criptográfica na KuCoin!

Inscreva-se na KuCoin agora! >>>

Baixe o aplicativo KuCoin >>>

Siga-nos no X (Twitter) >>>

Junte-se a nós no Telegram >>>

Participe das comunidades globais da KuCoin >>>

Aviso legal: Esta página foi traduzida usando tecnologia de IA (alimentada por GPT) para sua conveniência. Para informações mais precisas, consulte a versão original em inglês.