Guide Посібник Bybit

Як створити та налаштувати API-ключ для Bybit

Середній
Посібник Bybit
2023年9月14日

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

У цьому посібнику ви дізнаєтеся, як інтегрувати API Bybit з іншими автоматизованими застосунками для торгівлі. 

Ключові висновки:

  • API та API-ключі працюють у тісній взаємодії, що дає змогу застосункам взаємодіяти один з одним.

  • Bybit пропонує багато API: від WebSocket API і REST API до API історичного ринку.

  • Користувачі можуть скористатися цими API, налаштувавши свій інтерфейс та вподобання, а також автоматизувавши стратегії за допомогою копітрейдингу, щоб підвищити швидкість і точність торгівлі.

Що таке Bybit API?

Bybit API — це набір інтерфейсів прикладних програм (API), які дозволяють розробникам програмно взаємодіяти з платформою Bybit. Bybit — це найкраща у своєму класі біржа деривативів криптовалют, яка має варіанти торгівлі для різних цифрових активів. За допомогою API розробники можуть отримувати доступ до ринкових даних, керувати ордерами, здійснювати угоди та підписуватися на потоки даних.

API має кілька версій, які відповідають різним продуктам і функціям. Наприклад, V3 API підтримує торгівлю спотами, безстроковими контрактами USDC та опціонними контрактами, а V2 API підтримує торгівлю інверсними ф’ючерсними контрактами та ф’ючерсними контрактами. Для максимального рівня безпеки Bybit API використовує шифрування HMAC для автентифікації. Для інтеграції з Bybit API розробники можуть використовувати цілу низку інструментів і мов, зокрема Python, Node.js і WebSocket.

API та API-ключі

API відноситься до протоколу зв’язку, який використовує інший набір правил і мов, що дозволяє програмним застосункам взаємодіяти один з одним. Наприклад, веб-API використовує протоколи HTTP, що дозволяє розробникам отримувати доступ до вебресурсів через загальноприйняті формати даних, як-от JSON і XML

У свою чергу API-ключі можуть з’являтися у вигляді відкритих або приватних ключів. Вони функціонують як ключі автентифікації або маркери доступу, використовуючи ряд унікальних символів, які слугують формою автентифікації при запиті доступу до функції API. Ці ключі автентифікації генеруються постачальником API насамперед для відстеження використання API різними клієнтами або застосунками. 

Bybit V3 та V5 API: відмінності

Bybit V3 API — це попередня версія Bybit API. Вона підтримує лінійні та зворотні контракти як для звичайних, так і для єдиних акаунтів. З іншого боку, Bybit V5 API — це остання версія, що підтримує спотові, деривативні та опціонні контракти для єдиних акаунтів Bybit.

Ось деякі відмінності між V3 і V5 API:

  • Bybit API V3 охоплює лише конкретні торгові продукти, а інші продукти мають власний набір API. На відміну від цього, V5 API поєднує в собі API різних торгових продуктів, що дозволяє користувачам торгувати спотами, деривативами та опціонними контрактами через один API.

  • На відміну від V3, Bybit V5 API дає користувачам змогу змінювати свої акаунти на Єдиний торговий акаунт, що дозволяє обмінюватися коштами та використовувати їх у різних типах контрактів.

  • V5 API підтримує позики в режимі Єдиного торгового акаунта, використовуючи кілька активів як заставу для отримання маржі за торгівлю різними продуктами.

  • V5 API також забезпечує комбіновану маржу між USDT безстроковими, безстроковими контрактами USDC, ф’ючерсами USDC та опціонними контрактами для Єдиних торгових акаунтів.

Bybit V5 API створено на основі API V3, що полегшує користувачам процес оновлення шляхом коригування URL-адреси та полів інтерфейсу.

Докладніше:API-документація Bybit(документи API)

Як створити API-ключ на Bybit

Щоб використовувати Bybit зі сторонніми застосунками, спочатку потрібно створити API-ключ на платформі Bybit. Але перш ніж це зробити, важливо зрозуміти ліміт трафіку IP.

Розуміння ліміту трафіку IP

Ліміт трафіку IP регулює мережевий трафік на основі IP-адрес вхідних запитів. Він не дає користувачам повторювати дії занадто часто протягом певного часового діапазону. Bybit має різний ліміт трафіку для різних запитів, як-от загальнодоступні дані, приватні дані та розміщення ордерів. 

Якщо ви перевищите ліміт трафіку для певного типу запиту, ви отримаєте код помилки, і ваш запит буде відхилено. Щоб уникнути цього, ви повинні контролювати частоту запитів і відповідним чином коригувати її. Крім того, для деяких запитів слід використовувати WebSocket API замість REST API, оскільки запити WebSocket не враховуються в межах ліміту трафіку.

Покрокові інструкції з підключення API

Щоб використовувати Bybit API із застосунком або платформою, спочатку створіть API-ключ на Bybit, а потім підключіть його до бажаної платформи. Виконайте такі дії:

  1. Увійдіть у свій акаунт Bybit або зареєструйте акаунт Bybit.

  2. Натисніть на значок свого акаунта у верхньому правому куті екрана та виберіть API у розкривному меню.

  3. Перейдіть на вкладку Управління API та натисніть Створити новий ключ.

  4. Виберіть Системні API-ключі або Самостійно створені API-ключі.

  5. Виберіть Під’єднатися до сторонніх застосунків, виберіть сторонній застосунок із розкривного меню та назвіть API-ключ.

  6. Установіть дозволи для API-ключа (наприклад, інформація про акаунт, розміщення ордера, інформація про позицію) і натисніть Подати.

  7. Скопіюйте API-ключ і секрет і збережіть їх у безпечному місці.

  8. Увійдіть у сторонній застосунок і під’єднайте збережений API. 

Як під’єднати 3Commas API на Bybit

Якщо ви хочете використовувати на Bybit платформу для торгівлі криптовалютою 3Commas, спершу під’єднайте її за допомогою API-ключа. Для цього потрібно виконати такі кроки:

  1. Увійдіть у свій акаунт Bybit або зареєструйте акаунт Bybit.

  2. Натисніть на значок свого акаунта у верхньому правому куті екрана та виберіть API у розкривному меню.

  3. Перейдіть на вкладку Управління API та натисніть Створити новий ключ.

  4. Виберіть Системні API-ключі.

  5. Перейдіть до Під’єднатися до сторонніх застосунків і виберіть 3Commas в розкривному списку назви застосунку.

  6. Виберіть дозволи для API-ключа: інформація про акаунт, розміщення ордера, інформація про позицію тощо. (Ви також можете вибрати Лише читання, якщо хочете лише переглядати дані свого акаунта в 3Commas.)

  7. Натисніть Подати, щоб створити API-ключ. Ви побачите на екрані свій API-ключ і секретний ключ. Ви можете скопіювати їх у буфер обміну або завантажити їх як файл.

  8. Увійдіть у свій акаунт 3Commas або створіть новий.

  9. Перейдіть на сторінку Мої біржі та натисніть Додати біржу.

  10. Виберіть Bybit зі списку підтримуваних бірж і введіть свій API-ключ і секретний ключ, створений на Bybit. Вам також потрібно ввести свій ідентифікатор клієнта, який можна знайти на сторінці Змінити пароль на Bybit.

  11. Натисніть на Під’єднати, щоб зв’язати ваш акаунт Bybit із 3Commas.

Після виконання цих кроків ви можете використовувати 3Commas із Bybit та отримувати доступ до різних торгових інструментів і можливостей. Якщо вам потрібно оновити або видалити API-ключ, ви можете зробити це на сторінці «Управління API» на Bybit або на сторінці Мої біржі на 3Commas.

Як підключити Insilico API на Bybit

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

Ось як пов’язати акаунт Bybit із Insilico:

  1. Увійдіть у свій акаунт Bybit і натисніть на значок Акаунт у верхньому правому куті екрана.

  2. Натисніть на значок свого акаунта у верхньому правому куті екрана та виберіть API у розкривному меню.

  3. Перейдіть на вкладку Управління API та натисніть Створити новий ключ.

  4. Виберіть Системні API-ключі.

  5. Перейдіть до Під’єднатися до сторонніх застосунків і виберіть Термінал Insilico у розкривному меню. Це гарантує, що ключ буде прив’язаний до діапазону IP-адрес сервера Insilico.

  6. Виберіть дозволи для API-ключа: інформація про акаунт, розміщення ордерів та інформація про позицію. Ви також можете вибрати Лише читання для перегляду даних акаунта лише в Insilico.

  7. Натисніть Подати, щоб створити API-ключ. Ви побачите на екрані ключ і секретний ключ. За бажанням ви також можете скопіювати або завантажити їх як файл.

  8. Увійдіть у свій акаунт Insilico (або створіть новий).

  9. Перейдіть на сторінку Налаштування та натисніть Додати біржу.

  10. Виберіть Bybit зі списку підтримуваних бірж і введіть API-ключ і секретний ключ, створені на Bybit. Вам також потрібно ввести свій ідентифікатор клієнта, який можна знайти на сторінці Змінити пароль на Bybit.

  11. Натисніть на Під’єднати, щоб зв’язати ваш акаунт Bybit із Insilico.

Чи можна використовувати середовище тестування Bybit для тестування API?

Так. Ви можете використовувати середовище тестування Bybit для тестування API стільки часу, скільки забажаєте, проте дані та транзакції не є реальними та можуть не відображати реальні ринкові умови. Середовище тестування Bybit, також відоме як testnet, — це віртуальна торгова платформа, яка дає змогу тестувати стратегії та коди API, не ризикуючи реальними коштами. Вона надає доступ до API-сервісів Bybit, як-от REST API, WebSocket API та історичні ринкові дані.

Типи API на Bybit

Bybit API має три типи інтерфейсів. 

REST API

REST API — це інтерфейс, який дає змогу надсилати запити та отримувати відповіді за допомогою методів HTTP, як-от GET, POST, PUT і DELETE. Ви можете використовувати REST API для виконання різних дій на платформі Bybit: запит ринкових даних, розміщення ордерів, зміна ордерів і перевірка позицій. REST API ідеально підходить для запитів із низькою частотою та високою затримкою.

WebSocket API

Цей інтерфейс дає змогу встановити постійний зв’язок із сервером Bybit і отримувати оновлення в режимі реального часу за протоколом WebSocket. Ви можете використовувати WebSocket API, який містить дані WebSocket, щоб підписатися на різні теми щодо ринків і приватних даних, як-от книга ордерів, K-line, угоди, ставка фінансування, статус ордера та статус позиції. WebSocket API найкраще підходить для запитів із високою частотою та низькою затримкою.

Докладніше:Підписатися на WebSocket API.

Історичні ринкові дані

Ви можете завантажити загальнодоступні історичні ринкові дані у форматі CSV та використовувати ці дані для перевірки своїх стратегій та аналізу ринкових тенденцій. Історичні ринкові дані включають знімки книг ордерів, дані K-line, дані угод і дані щодо ставки фінансування.

Докладніше:Завантажте API ринкових даних Bybit тут.

Які переваги можна отримати від Bybit API?

Bybit API — це ефективний інструмент, який може допомогти покращити враження від торгівлі та її ефективність. Ось кілька способів, як ви можете це зробити:

  • Автоматизуйте свої торгові стратегії швидко та точно. Bybit API дає змогу створювати та запускати торгові боти, які можуть розміщувати, змінювати та скасовувати ордери, а також керувати позиціями на основі попередньо визначених логіки та параметрів. API також дає змогу інтегруватися зі сторонніми торговими інструментами та можливостями.

  • Отримайте доступ до реальних та історичних ринкових даних. Підпишіться на різні теми щодо ринкових даних та отримуйте оновлення в режимі реального часу за допомогою WebSocket API. Ви також можете завантажити загальнодоступні історичні ринкові дані у форматі CSV, щоб проаналізувати тенденції ринку, визначити можливості для торгівлі та перевірити свої стратегії.

  • Налаштуйте свій власний інтерфейс користувача та вподобання. Створіть власний інтерфейс користувача та інформаційну панель, щоб відображати інформацію та функції відповідно до ваших потреб. Ви можете змінити свої налаштування та конфігурації, як-от режим маржі, рівень кредитного плеча та ліміт ризику.

Чи Bybit API безкоштовний?

Користувачі Bybit можуть використовувати Bybit API безкоштовно. Однак до ваших транзакцій на платформі застосовуватимуться стандартна комісія за торгівлю та фінансування.

Підсумки

Bybit API надає розробникам корисні інструменти та інтерфейси, аби вони могли взаємодіяти з платформою Bybit за допомогою коду. Ці інструменти дозволяють автоматизувати торгові стратегії, отримувати доступ до ринкових даних у режимі реального часу та налаштовувати власний інтерфейс користувача. 

Виконайте наведені вище дії, щоб налаштувати API-ключ на Bybit і під’єднати його до сторонніх застосунків, як-от 3Commas або Insilico. Важливо відзначити відмінності між Bybit V3 та V5 API, а також залишатися в межах ліміту трафіку IP для безперешкодної торгівлі.