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

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:
-
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.
-
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.
-
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.
-
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.
-
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! >>>
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.