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

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

04/07/2025, 06:33:02

Imagem Personalizada

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:

  1. 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.

  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á forçadamente as ordens ordinárias e avançadas de baixa frequência não executadas durante o processo de migração.

  1. 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.

  1. 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.

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

Baixe o App da 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.