Оголошення про оновлення KuCoin Margin API

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} Запит активних торгowych пар: /api/v3/hf/margin/order/active/symbols

Попередження про ризики

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

Дякуємо за вашу підтримку!

Команда KuCoin

Знайдіть наступну криптовалютну скарбницю на KuCoin!

Зареєструйтеся на KuCoin зараз! >>>

Завантажте додаток KuCoin >>>

Підписуйтесь на нас у X (Twitter) >>>

Приєднуйтесь до нас у Telegram >>>

Приєднуйтесь до глобальних спільнот KuCoin >>>

Відмова від відповідальності: Для вашої зручності цю сторінку було перекладено за допомогою технології ШІ (на базі GPT). Для отримання найточнішої інформації дивіться оригінальну англійську версію.