Оголошення про оновлення KuCoin Margin API
Шановні користувачі 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 не є обов’язковими, але після виконання міграції система автоматично скасовує замовлення з низькою частотою та переказує активи з низькою частотою на акаунти з високою частотою.
Важливі зауваження:
-
Тимчасова недоступність акаунту (на це впливатимуть як користувачі C-end, так і користувачі API);
Під час виконання міграції акаунти користувачів тимчасово будуть недоступні протягом 2–3 хвилин, що стосується функцій запиту активів, торгівлі та переказу. Будь ласка, здійсніть операції заздалегідь, щоб уникнути впливу на транзакції.
-
Примусова відміна замовлень з низькою частотою;
Якщо користувач не скасуватиме замовлення з низькою частотою заздалегідь, система примусово скасує невиконані звичайні та просунуті замовлення з низькою частотою під час процесу міграції.
-
Активи на короткий час відображаються як «заморожені»;
Під час підготовки до міграції високочастотні активи можуть відображатися як «заморожені» у старому інтерфейсі і повернуться до нормального стану після завершення міграції.
-
Поради щодо сумісності інтерфейсу;
Старий інтерфейс більше не підтримуватиме часті запити, пов’язані з акаунтом. Переконайтесь, що ви здійснили перехід заздалегідь, інакше може бути повернуто виняток.
-
Офіційна міграція відбудеться через 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} Запит активних торгowych пар: /api/v3/hf/margin/order/active/symbols |
Попередження про ризики
Маржинальна торгівля — це практика позичання коштів при відносно невеликій сумі капіталу для торгівлі фінансовими активами з метою отримання більшої прибутковості. Однак через ринкові ризики, коливання цін та інші фактори вам настоятельно рекомендується бути обережним у своїх інвестиційних діях, вибирати відповідний рівень кредитного плеча для маржинальної торгівлі та вчасно обмежувати збитки. KuCoin не несе відповідальності за будь-які збитки, що виникли внаслідок торгівлі.
Дякуємо за вашу підтримку!
Команда KuCoin
Знайдіть наступну криптовалютну скарбницю на KuCoin!
Зареєструйтеся на KuCoin зараз! >>>
Підписуйтесь на нас у X (Twitter) >>>
Приєднуйтесь до нас у Telegram >>>
Приєднуйтесь до глобальних спільнот KuCoin >>>
Відмова від відповідальності: Для вашої зручності цю сторінку було перекладено за допомогою технології ШІ (на базі GPT). Для отримання найточнішої інформації дивіться оригінальну англійську версію.