Оголошення про оновлення API для маржинальної торгівлі на KuCoin
Шановні користувачі KuCoin,
Для забезпечення кращого торгового середовища та оптимізації досвіду торгівлі, API для маржинальної торгівлі на платформі KuCoin проходить міграцію з високою частотою запитів та оновлення. Ця міграція відбуватиметься поетапно і очікується, що буде завершена до кінця 2025 року.
1. Обсяг міграції:
Для користувачів, які активували Маржу, якщо під час міграції немає маржинальних позицій або активів, це не вплине на вас.
2. Вплив міграції:
2.1 Не-API користувачі (користувачі C-кінця)
- Досвід використання Web/застосунку залишиться незмінним до і після міграції.
2.2 API користувачі
- Ця міграція певною мірою вплине на метод виклику API-інтерфейсу та відображення статусу активів. Міграція буде повідомлятися поетапно. Будь ласка, виконайте відповідні дії після отримання сповіщення на електронну пошту. Система виконає міграцію через 7 днів після відправлення електронного листа. (Щоб зменшити вплив, ви можете заздалегідь переключитися на API з високою частотою запитів).
3. Процес міграції:
Крок 1: Ручне очищення ордерів з низькою частотою
a. Користувачам необхідно самостійно скасувати ордери, розміщені через API з низькою частотою або через C-кінцеві Web/застосунки;
b. Ордери з високою частотою скасовувати не потрібно;
-
Якщо ви не скасуєте ордери самостійно, система змусить скасувати їх під час процесу міграції (включаючи звичайні та розширені ордери).
-
Якщо ви не впевнені у статусі своїх ордерів, будь ласка, зверніться до служби підтримки клієнтів для консультації.
Крок 2: Ручне переміщення активів з низькою частотою (API користувачі)
a. Користувачам необхідно вручну перемістити активи з акаунтів з низькою частотою на акаунти з високою частотою та переключитися на новий API-інтерфейс (деталі див. у документації API).
b. Отримайте квоти на переведення - KUCOIN API На даний момент активи на C-сторінці (Web та App) відображаються як "FROZEN", і високочастотні ордери неможливо виконати.
Крок 3: Початок міграції
*Кроки 1 та 2 не є обов’язковими, але після виконання міграції система автоматично скасує низькочастотні ордери та переведе низькочастотні активи на високочастотні акаунти.
Важливі примітки:
-
Тимчасова недоступність акаунтів (це вплине як на користувачів C-сторінки, так і на 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 Interface: /api/v1/accounts/ledgers
- Книга операцій доступна для запитів як для високочастотних, так і для низькочастотних акаунтів до і після міграції за звичним часовим діапазоном.
2. V3 Interface: /api/v3/hf/margin/account/ledgers
- Підтримується лише запит транзакцій для високочастотних акаунтів, причому часовий діапазон обмежений останніми трьома днями.
Користувачі можуть вибирати інтерфейс залежно від своїх потреб.
Переводи
-
Інтерфейс для переводів залишається без змін. Попередній інтерфейс можна використовувати для переводів між високочастотними та низькочастотними акаунтами.
-
До міграції: підтримуються переводи між високочастотними та низькочастотними акаунтами в межах одного користувача.
-
Після міграції: margin та margin_v2 розглядатимуться як один і той самий акаунт, а переводи між цими двома акаунтами більше не підтримуватимуться (аналогічно для ізольованої маржі).
-
Запити історичних ордерів
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 вже зараз! >>>
Слідкуйте за нами на X (Twitter ) >>>
Приєднуйтесь до нас у Telegram >>>
Приєднуйтесь до глобальних спільнот KuCoin >>>
Відмова від відповідальності: Для вашої зручності цю сторінку було перекладено за допомогою технології ШІ (на базі GPT). Для отримання найточнішої інформації дивіться оригінальну англійську версію.