Многие сторонние платформы для работы с криптобиржами подключаются к аккаунту через API — программный интерфейс биржи. С его помощью приложение может получать доступные данные и, если у него есть нужные разрешения, отправлять торговые команды.
В статье разберём, чем API-ключ отличается от пароля, какие разрешения можно выдать и как настроить подключение безопасно.
Содержание
- Что такое API простыми словами
- Как работает API криптобиржи
- Что такое API-ключ и чем он отличается от пароля
- Где используют API-ключи
- Какие права доступа можно выдать
- Возможности и риски подключения через API
- Как создать API-ключ: общий порядок
- Правила безопасности
- Ключевые выводы
Что такое 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-ключ: общий порядок
Интерфейс бирж различается, но обычно подключение включает следующие шаги:
- Войдите в аккаунт и включите двухфакторную аутентификацию (2FA), если она доступна.
- Найдите раздел «API», «Управление API» или похожий раздел в настройках аккаунта.
- Создайте новый ключ и задайте ему название, по которому сможете понять, для какой платформы он используется.
- Выберите только те разрешения, которые нужны платформе для её функций.
- Если биржа и платформа поддерживают ограничение по IP-адресам, добавьте адреса, указанные в официальной инструкции платформы.
- Подтвердите создание ключа способом, который запрашивает биржа.
- Скопируйте данные ключа и введите их только в официальном интерфейсе платформы.
На многих биржах Secret Key показывается только при создании ключа. Если вы не сохранили его или сомневаетесь, что он защищён, удалите ключ и создайте новый. Названия разделов и порядок шагов на разных биржах могут отличаться, поэтому для пользователей Fetti Flow в базе знаний собраны пошаговые инструкции по созданию и безопасной настройке API-ключей для каждой поддерживаемой биржи.
Правила безопасности
- Не включайте право на вывод средств, если платформе оно не требуется.
- Создавайте отдельный ключ для каждой платформы: так проще понять, какой доступ нужно отозвать.
- Ограничивайте права ключа минимально необходимым набором.
- Используйте ограничение по IP-адресам, если его поддерживают биржа и платформа и у вас есть официально указанные адреса для настройки.
- Храните Secret Key в надёжном месте. Не пересылайте его в мессенджерах и не сохраняйте на скриншотах.
- Проверяйте адрес сайта перед подключением. Не вводите данные ключа на страницах из подозрительных ссылок.
- Регулярно проверяйте список активных ключей и удаляйте те, которыми больше не пользуетесь.
- Помните, что 2FA защищает вход в аккаунт и управление его настройками, но не защищает сам API-ключ от утечки и не заменяет ограничение прав и безопасное хранение данных ключа.
- При подозрении на утечку удалите ключ в аккаунте биржи и создайте новый.
Ключевые выводы
API позволяет платформам взаимодействовать с биржей: получать доступные данные и, при наличии необходимых прав, выполнять действия в аккаунте. API-ключ не равен паролю, но торговые разрешения дают платформе возможность размещать ордера.
Выдавайте ключу только минимально необходимые права и соблюдайте правила безопасности из этой статьи: так последствия возможной утечки будут минимальными.
Возможности и настройки API различаются у бирж. Перед созданием ключа сверяйтесь с актуальными инструкциями площадки и подключаемой платформы.
Материал носит информационный характер. Интерфейс и названия настроек зависят от конкретной биржи. Торговля криптовалютами связана с риском убытков.