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

04/07/2025 14:33:02

Пользовательский

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

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

1. Объем миграции:

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

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

     2.1 Пользователи без API (конечные пользователи)

  • Пользовательский опыт на веб-сайте/приложении останется неизменным до и после миграции.

     2.2 Пользователи API

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

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

Шаг 1: Вручную очистите заказы с низкой частотой

a. Пользователям необходимо отменить заказы, размещенные через низкочастотный API и C-end (веб/приложение), самостоятельно;

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

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

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

Шаг 2: Вручную выполните перевод активов с низкой частотой (пользователи API)

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

b. Получить квоты на перевод — KUCOIN API В настоящее время активы на C-стороне (веб-сайт и приложение) отображаются как "ЗАМОРОЖЕННЫЕ", и нельзя выполнять высокочастотные ордера.

Шаг 3: Начать миграцию

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

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

  1. Временная недоступность аккаунта (будут затронуты как пользователи C-end, так и пользователи 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 для скрещенной маржи и /v1/isolated/accounts для изолированной маржи) останутся доступными после миграции, но активы с высокой частотой будут отображаться как «Замороженные» для пользователей, которые еще не выполнили миграцию.

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

1. V1 Интерфейс: /api/v1/accounts/ledgers

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

2. Интерфейс V3: /api/v3/hf/margin/account/ledgers

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

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

Переводы

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

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

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

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

1. V1 Интерфейс: /api/v1/orders?status=done

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

2. Интерфейс V3: /api/v3/hf/margin/orders/done

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

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

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

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

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

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

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

Действие

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

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

Размещение заказа

Обычный заказ: /api/v1/margin/order

Стоп-ордер: /api/v1/stop-order

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

Отмена заказа

По ID заказа: /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). Для получения наиболее точной информации обратитесь к оригинальной английской версии.