Объявление об обновлении API Маржи KuCoin

Объявление об обновлении API Маржи KuCoin

04.07.2025, 06:33:02

Индивидуальное изображение

Уважаемые пользователи KuCoin,

Для обеспечения более комфортных условий торговли и оптимизации пользовательского опыта, API Маржи KuCoin проходит высокочастотную миграцию и обновление.Данный процесс будет осуществляться в несколько этапов и, как ожидается, завершится к концу 2025 года.

1. Область миграции:

Для пользователей, которые активировали Маржу, если во время миграции у вас нет маржевых позиций или активов, это никак не повлияет на вас.

2. Влияние миграции:

2.1 Не-API пользователи (пользователи с интерфейсом Web/App)

  • Опыт использования интерфейса Web/App останется неизменным до и после миграции.

2.2 API-пользователи

  • Данная миграция окажет определенное влияние на способ вызова интерфейса API и отображение статуса активов. Миграция будет проводиться поэтапно, и уведомления будут отправляться по электронной почте. Просим выполнить соответствующие действия сразу после получения уведомления. Миграция системы начнется через 7 дней после отправки письма. (Чтобы минимизировать влияние, вы можете заранее переключиться на высокочастотный API).

3. Процесс миграции:

Шаг 1: Ручное удаление низкочастотных ордеров

a. Пользователи должны самостоятельно отменить ордера, размещенные через низкочастотный API и интерфейс (Web/App);

b. Высокочастотные ордера отменять не требуется;

  • Если вы не отмените ордера самостоятельно, система принудительно отменит ордера в процессе миграции (включая обычные и продвинутые ордера).

  • Если вы не уверены в статусе ваших ордеров, пожалуйста, обратитесь в службу поддержки для консультации.

Шаг 2: Ручное перенесение низкочастотных активов (API-пользователи)

a. Пользователи должны вручную перенести активы низкочастотного аккаунта в высокочастотные аккаунты и переключиться на новый интерфейс API (см. api-doc для подробностей).

b.Получение квот на перенос - KUCOIN APIНа данный момент активы на C-конце (веб и приложение) отображаются как «FROZEN», и операции с высокочастотными ордерами не могут быть выполнены.

Шаг 3: Начало миграции

*Шаги 1 и 2 не являются обязательными, но после выполнения миграции система автоматически отменит низкочастотные ордера и переведет низкочастотные активы в высокочастотные аккаунты.

Важные заметки:

  1. Временная недоступность аккаунта (это затронет как пользователей C-конца, так и пользователей API);

Во время выполнения миграции аккаунты пользователей будут временно недоступны в течение 2–3 минут, что затронет функции запроса активов, торговли и перевода. Пожалуйста, планируйте свои операции заранее, чтобы избежать сбоев в транзакциях.

  1. Принудительная отмена низкочастотных ордеров;

Если пользователь не отменит низкочастотный ордер заранее, система принудительно отменит невыполненные обычные и продвинутые низкочастотные ордера в процессе миграции.

  1. Активы отображаются как «замороженные» на короткое время;

На этапе подготовки к миграции высокочастотные активы могут отображаться как «замороженные» в старом интерфейсе, но вернутся в нормальный режим после завершения миграции.

  1. Совместимость интерфейса;

Старый интерфейс больше не будет поддерживать запросы, связанные с высокочастотными аккаунтами. Обязательно завершите переход заранее, иначе могут возникнуть исключения.

  1. Официальная миграция начнется через 7 дней после уведомления по электронной почте;

Официальная миграция начнется через 7 дней после отправки уведомления по электронной почте. Пользователям рекомендуется тщательно следить за своими почтовыми ящиками и завершить все необходимые приготовления до даты миграции, чтобы обеспечить плавный переход и избежать сбоев в обслуживании.

Подробные сведения о миграции:

Запросы активов

  • Рекомендуем использовать новый API-интерфейс для запросов активов:

    • Запрос активов перекрестного маржинального аккаунта: /api/v3/margin/accounts

    • Запрос активов изолированного маржинального аккаунта: /api/v3/isolated/accounts

  • После миграции данные активов до и после миграции останутся согласованными. После завершения миграции все запросы, включая margin, margin_v2 и ALL, будут возвращать согласованные результаты (аналогично для изолированных аккаунтов).

Примечание:Старые интерфейсы запросов активов (/api/v1/margin/account для cross-margin и /v1/isolated/accounts для isolated margin) будут доступны после миграции, но высокочастотные активы будут отображаться как "Замороженные" для пользователей, которые еще не завершили миграцию.

Запросы книги транзакций

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

  • Книга транзакций может быть запрошена как для высокочастотных, так и для низкочастотных аккаунтов до и после миграции, с тем же диапазоном времени, как и ранее.

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

  • Поддерживает только запросы транзакций высокочастотных аккаунтов, с ограниченным диапазоном времени — последние три дня.

Пользователи могут выбрать интерфейс в зависимости от своих потребностей.

Переводы

  • Интерфейс перевода остается неизменным. Предыдущий интерфейс все еще может использоваться для переводов между высокочастотными и низкочастотными аккаунтами.

    • До миграции: переводы между высокочастотными и низкочастотными аккаунтами одного пользователя поддерживаются.

    • После миграции: margin и margin_v2 будут рассматриваться как один аккаунт, и переводы между этими двумя аккаунтами больше не будут поддерживаться (аналогично для isolated margin).

Запросы исторических ордеров

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

  • Исторические ордера могут быть запрошены как для высокочастотных, так и для низкочастотных ордеров, с тем же диапазоном времени.

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

  • Поддерживает только запросы исторических высокочастотных ордеров и может возвращать данные только за последние три дня. Пользователи могут выбирать интерфейс в зависимости от своих потребностей.

Размещение ордеров / Отмена ордеров / Запрос активных ордеров

1. V1 Interface: Поддерживает размещение, отмену и запрос активных низкочастотных ордеров.

2. V3 Interface: Поддерживает размещение, отмену и запрос активных высокочастотных ордеров.

Высокочастотные и низкочастотные ордера несовместимы друг с другом, включая функции take-profit и stop-loss. Пользователи должны использовать соответствующий интерфейс в зависимости от типа ордера.

Изменения интерфейсов после миграции:

  • Примечание: рекомендуется заранее уточнить изменения интерфейсов до и после миграции, чтобы избежать проблем с использованием.

Действие

Интерфейс до миграции

Интерфейс после миграции

Размещение ордера

Обычный ордер: /api/v1/margin/order

Stop-ордер: /api/v1/stop-order

Обычный ордер: /api/v3/hf/margin/order Стоп-ордер: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

Отмена ордера

По orderId: /api/v1/orders/{orderId}

По clientOid: /api/v1/order/client-order/{clientOid}

Массовая отмена: /api/v1/orders

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

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

Массовая отмена: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

Запрос активных ордеров

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Запрос активных торговых пар: /api/v3/hf/margin/order/active/symbols


Предупреждение о рисках

Маржинальная торговля подразумевает использование заемных средств при относительно небольшом объеме капитала для торговли финансовыми активами и получения более высокой прибыли. Однако из-за рыночных рисков, колебаний цен и других факторов настоятельно рекомендуется проявлять осмотрительность в инвестиционных действиях, выбирать подходящий уровень кредитного плеча для маржинальной торговли и своевременно ограничивать убытки.  KuCoin  не несет ответственности за любые убытки, возникшие в результате торговли.

Спасибо за вашу поддержку!

Команда KuCoin

Найдите следующий крипто гем на KuCoin!

Зарегистрируйтесь на KuCoin сейчас! >>>

Скачайте приложение KuCoin>>>

Подписывайтесь на нас в X (Twitter) >>>

Присоединяйтесь к нашему Telegram>>>

Присоединяйтесь к глобальным сообществам KuCoin>>>

Отказ от ответственности: Эта страница была переведена для вашего удобства с использованием технологии искусственного интеллекта (на базе GPT). Для получения наиболее точной информации обратитесь к оригинальной английской версии.