Начать работу 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 различаются у бирж. Перед созданием ключа сверяйтесь с актуальными инструкциями площадки и подключаемой платформы.

Материал носит информационный характер. Интерфейс и названия настроек зависят от конкретной биржи. Торговля криптовалютами связана с риском убытков.