Почати роботу UKENRU
Усі статті

API-ключ криптобіржі: що це і як безпечно його налаштувати

API-ключ криптобіржі: що це і як безпечно його налаштувати

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

У статті розберемо, чим API-ключ відрізняється від пароля, які дозволи можна надати і як безпечно налаштувати підключення.

Зміст

  1. Що таке API простими словами
  2. Як працює API криптобіржі
  3. Що таке API-ключ і чим він відрізняється від пароля
  4. Де використовують API-ключі
  5. Які права доступу можна надати
  6. Можливості та ризики підключення через API
  7. Як створити API-ключ: загальний порядок
  8. Правила безпеки
  9. Ключові висновки

Що таке API простими словами

API (Application Programming Interface) — це інтерфейс, за допомогою якого одна програма надсилає іншій запити та отримує відповіді. У випадку з криптобіржею запит може стосуватися публічних ринкових даних, інформації про акаунт або торгових операцій. Для доступу до захищених даних і дій зазвичай потрібна авторизація.

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

Через API платформа може, залежно від типу запиту та наданих дозволів:

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

Як працює API криптобіржі

Після налаштування підключення платформа надсилає біржі запити через API. Для захищених методів біржа перевіряє API-ключ, підпис запиту та наявність необхідних дозволів. Потім вона повертає дані, виконує дозволену дію або відхиляє запит — наприклад, якщо ключу бракує прав або запит оформлено неправильно.

Через API можна отримувати як публічні, так і захищені дані. Для публічних ринкових даних авторизація може не знадобитися. Баланс, історія операцій та інші відомості акаунта доступні через захищені методи API і лише за наявності відповідних дозволів. Правила та назви налаштувань залежать від біржі.

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

Що таке API-ключ і чим він відрізняється від пароля

Для авторизації на багатьох біржах використовують API Key і Secret Key. API Key ідентифікує ключ, а Secret Key застосовується для створення підпису захищених запитів. Деякі біржі додатково вимагають passphrase — окрему парольну фразу, задану під час створення ключа. Конкретний механізм залежить від біржі та типу API.

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

Передавайте дані ключа лише в офіційному інтерфейсі платформи, яку підключаєте, і після перевірки її адреси. Не надсилайте Secret Key у листуванні та не передавайте його людині, яка представляється співробітником підтримки.

Де використовують API-ключі

Торгові платформи та робота з ціновими розбіжностями

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

Наприклад, Fetti Flow використовує API, щоб відстежувати цінові розбіжності між біржами та після підтвердження угоди надсилати ордери для відкриття протилежних ф’ючерсних позицій: LONG на одній біржі та SHORT на іншій. Для підключення користувач створює API-ключі з обмеженими правами на вибраних біржах і надає їм права лише на читання даних і торгівлю ф’ючерсами. Право на виведення коштів не потрібне: активи завжди залишаються на біржових рахунках користувачів.

Трекери портфеля

Трекер портфеля може збирати доступні дані про активи на кількох біржах в одному інтерфейсі. Для перегляду балансів зазвичай достатньо прав на читання, але точний набір дозволів залежить від функцій платформи та конкретної біржі.

Платформи для обліку угод

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

Які права доступу можна надати

Біржі по-різному називають і групують дозволи API-ключів. Нижче наведено поширені приклади; доступні налаштування потрібно перевіряти в інтерфейсі конкретної біржі.

Дозвіл Що дає змогу робити Коли може знадобитися
Читання Перегляд дозволених даних акаунта, балансів або історії Для аналітики, обліку та перегляду даних
Спотова торгівля Створення та скасування ордерів на спотовому ринку Для платформ, які розміщують спотові ордери
Ф’ючерсна торгівля Відкриття та закриття позицій на ф’ючерсному ринку Для платформ, що працюють із ф’ючерсами
Внутрішні перекази Переказ активів між рахунками біржі Лише якщо конкретній функції дійсно потрібен такий доступ
Виведення коштів Виведення активів з біржі Для більшості сторонніх торгових платформ не потрібне

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

Можливості та ризики підключення через API

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

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

Як створити API-ключ: загальний порядок

Інтерфейс бірж відрізняється, але зазвичай підключення включає такі кроки:

  1. Увійдіть в акаунт і ввімкніть двофакторну автентифікацію (2FA), якщо вона доступна.
  2. Знайдіть розділ «API», «Керування API» або схожий розділ у налаштуваннях акаунта.
  3. Створіть новий ключ і задайте йому назву, за якою зможете зрозуміти, для якої платформи він використовується.
  4. Виберіть лише ті дозволи, які потрібні платформі для її функцій.
  5. Якщо біржа та платформа підтримують обмеження за IP-адресами, додайте адреси, вказані в офіційній інструкції платформи.
  6. Підтвердьте створення ключа способом, який запитує біржа.
  7. Скопіюйте дані ключа та введіть їх лише в офіційному інтерфейсі платформи.

На багатьох біржах Secret Key показується лише під час створення ключа. Якщо ви не зберегли його або сумніваєтеся, що він захищений, видаліть ключ і створіть новий. Назви розділів і порядок кроків на різних біржах можуть відрізнятися, тому для користувачів Fetti Flow у базі знань зібрано покрокові інструкції зі створення та безпечного налаштування API-ключів для кожної підтримуваної біржі.

Правила безпеки

  • Не вмикайте право на виведення коштів, якщо платформі воно не потрібне.
  • Створюйте окремий ключ для кожної платформи: так простіше зрозуміти, який доступ потрібно відкликати.
  • Обмежуйте права ключа мінімально необхідним набором.
  • Використовуйте обмеження за IP-адресами, якщо його підтримують біржа та платформа і у вас є офіційно вказані адреси для налаштування.
  • Зберігайте Secret Key у надійному місці. Не пересилайте його в месенджерах і не зберігайте на скриншотах.
  • Перевіряйте адресу сайту перед підключенням. Не вводьте дані ключа на сторінках із підозрілих посилань.
  • Регулярно перевіряйте список активних ключів і видаляйте ті, якими більше не користуєтеся.
  • Пам’ятайте, що 2FA захищає вхід в акаунт і керування його налаштуваннями, але не захищає сам API-ключ від витоку і не замінює обмеження прав та безпечного зберігання даних ключа.
  • У разі підозри на витік видаліть ключ в акаунті біржі та створіть новий.

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

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

Надавайте ключу лише мінімально необхідні права та дотримуйтеся правил безпеки з цієї статті: так наслідки можливого витоку будуть мінімальними.

Можливості та налаштування API відрізняються залежно від біржі. Перед створенням ключа звіряйтеся з актуальними інструкціями біржі та платформи, яку підключаєте.

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