Anúncio de Atualização da API de Margem 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 Margem da KuCoin está passando por uma migração e atualização de alta frequência.Esta migração será realizada em vários lotes e está prevista para ser concluída até o final de 2025.
1. Escopo da Migração:
Para os usuários que ativaram a Margem, se não houver posições ou ativos de Margem durante a migração, não haverá impacto para você.
2. Impacto da Migração:
2.1 Usuários não-API (Usuários finais - Web/App)
- A experiência do usuário na Web/App permanecerá inalterada antes e após a migração.
2.2 Usuários de API
- Esta migração terá certo impacto no método de chamada da interface API e na exibição do status dos ativos. A migração será notificada em lotes. Realize as operações correspondentes dentro do prazo após receber a notificação por e-mail. O sistema migrará 7 dias após o envio do e-mail. (Para reduzir o impacto, você pode mudar para a API de alta frequência com antecedência).
3. Processo de Migração:
Passo 1: Limpar manualmente ordens de baixa frequência
a. Os usuários precisam cancelar, por conta própria, as ordens colocadas pela API de baixa frequência e C-end (Web/App);
b. Ordens de alta frequência não precisam ser canceladas;
-
Se você não cancelar ativamente, o sistema forçará o cancelamento das ordens durante o processo de migração (incluindo ordens comuns e avançadas).
-
Se não confirmar o status de suas ordens, entre em contato com o serviço de atendimento ao cliente para consulta.
Passo 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 mudar para a nova interface API (consulte api-doc para detalhes).
b.Obter Cotas de Transferência - API KUCOINNo momento, os ativos no C-end (Web e App) são exibidos como "FROZEN", 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, ao executar a migração, o sistema cancelará automaticamente ordens de baixa frequência e transferirá os ativos de baixa frequência para contas de alta frequência.
Notas Importantes:
-
Indisponibilidade temporária da conta (tanto para usuários do C-end quanto para usuários de API serão afetados);
Durante a execução da migração, as contas dos usuários ficarão temporariamente indisponíveis por 2-3 minutos, afetando as funções de consulta de ativos, negociação e transferência. Organize suas operações com antecedência para evitar impacto nas 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á forçadamente as ordens ordinárias e avançadas de baixa frequência não executadas durante o processo de migração.
-
Os ativos serão exibidos como "congelados" por um curto período;
Durante a fase de preparação da migração, os ativos de alta frequência podem ser exibidos como "congelados" na interface antiga, retornando ao normal após a conclusão da migração.
-
Dicas de compatibilidade da interface;
A interface antiga não suportará mais consultas relacionadas a contas de alta frequência. Certifique-se de completar a mudança com antecedência, caso contrário, uma exceção poderá ser retornada.
-
A migração oficial ocorrerá 7 dias após o envio do e-mail de notificação;
A migração oficial começará 7 dias após o envio do e-mail de notificação. Recomendamos que os usuários monitorem suas caixas de entrada de perto e concluam todas as preparações necessárias antes da data de migração para garantir uma transição tranquila e evitar interrupções no serviço.
Conteúdo Detalhado da Migração:
Consultas de Ativos
-
Recomendamos usar a nova interface de API para consultas de ativos:
-
Consulta de ativos de contas de margem cruzada: /api/v3/margin/accounts
-
Consulta de ativos de contas 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, as consultas tanto de margem, margem_v2 quanto ALL retornarão resultados consistentes (da mesma forma para contas isoladas).
Nota: As interfaces antigas de consulta de ativos (/api/v1/margin/account para margem cruzada e /v1/isolated/accounts para margem isolada) continuarã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 de Registro de Transações
1. V1 Interface: /api/v1/accounts/ledgers
- O registro pode ser consultado para contas de alta e baixa frequência antes e depois da migração, com o mesmo intervalo de tempo de antes.
2. V3 Interface: /api/v3/hf/margin/account/ledgers
- Essa interface suporta apenas a consulta de transações de contas de alta frequência, com um intervalo de tempo limitado aos últimos três dias.
Os usuários podem escolher a interface com base em 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: Transferências entre contas de alta e baixa frequência dentro do mesmo usuário são suportadas.
-
Após a Migração: margin e margin_v2 serão tratados como a mesma conta, e transferências entre essas duas contas não serão mais suportadas (o mesmo se aplica para margem isolada).
-
Consultas de Ordens Históricas
1. V1 Interface: /api/v1/orders?status=done
- As ordens históricas podem ser consultadas para ordens de alta e baixa frequência, com o mesmo intervalo de tempo.
2. V3 Interface: /api/v3/hf/margin/orders/done
- Essa interface suporta apenas a consulta de ordens de alta frequência e pode retornar dados somente dos últimos três dias. Os usuários podem escolher de acordo com suas necessidades.
Criação de Ordens/Cancelamento de Ordens/Consulta de Ordens Ativas
1. V1 Interface: Suporta a criação, o cancelamento e a consulta de ordens ativas de baixa frequência.
2. V3 Interface: Suporta a criação, o cancelamento e a consulta de ordens ativas de alta frequência.
Ordens de alta e baixa frequência não são compatíveis entre si, incluindo as funções de take-profit e stop-loss. Os usuários devem utilizar a interface correspondente com base no tipo de ordem.
Alterações na Interface de Migração:
-
Nota: Recomenda-se esclarecer as alterações nas interfaces envolvidas antes e depois da migração com antecedência para evitar impacto no uso.
|
Ação |
Interface Antes da Migração |
Interface Após a Migração |
|
Criação de Ordens |
Ordem Regular: /api/v1/margin/order Ordem Stop: /api/v1/stop-order |
Ordem Regular: /api/v3/hf/margin/order Ordem Stop: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order |
|
Cancelamento de Ordem |
Por orderId: /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 Ordens Ativas |
/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 tomar empréstimos com uma quantidade relativamente menor de capital para negociar ativos financeiros e obter lucros maiores. No entanto, devido aos riscos de mercado, flutuações de preços e outros fatores, recomendamos fortemente que você aja com prudência em suas decisões de investimento, adote um nível de alavancagem apropriado para negociação de margem e pare suas perdas de forma oportuna. A KuCoin não assume qualquer responsabilidade por perdas decorrentes da negociação.
Agradecemos pelo seu apoio!
A Equipe KuCoin
Encontre a Próxima Joia Cripto na KuCoin!
Cadastre-se na KuCoin agora! >>>
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.