Bitsgap API: Запустите свой собственный торговый алгоритм на 17 биржах

Настройка собственной автоматизации торговли раньше занимала целую неделю. Нужно было изучить документацию по API одной биржи, реализовать её схему подписи, учесть все особенности, а затем повторить всё это для следующей биржи. Добавить сервер, реализовать логику переподключения, придумать способ тестирования без риска потерять деньги.

API Bitsgap избавляет от этой недели. Одна ключевая пара охватывает 17 бирж, демо-площадки уже доступны, а подключение к вашей бирже — то же самое, что используют ваши боты. Среди аккаунтов, где это настроено, медианное время от создания ключа до первого успешного подписанного запроса составляет 13 минут. API включён бесплатно во все тарифы, включая Free.

Что такое торговый API на самом деле

API — это фиксированный список команд, которые одна программа может отправлять другой. Торговый API — это такой список для Market: узнать текущую цену, проверить баланс, разместить ордер, отменить ордер, закрыть позицию. Ваша программа отправляет команду, сервер выполняет действие и возвращает ответ. Всё, что вы можете сделать вручную в Bitsgap, ваш код может выполнять автоматически по своему расписанию.

Версия Bitsgap построена вокруг одной идеи, называемой топик — это именованный объект, который вам нужен. price, balance, orders, order_place. Вы указываете топик, передаёте его параметры и получаете либо единичный снимок, либо поток обновлений в реальном времени.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

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

Почему бы сразу не перейти на биржу

Вы можете так поступить, и для одной площадки это вполне разумный выбор. Однако когда количество площадок превышает одну, меняются три вещи.

У каждой биржи своя собственная схема подписи, поэтому добавление второй площадки означает необходимость второй реализации с нуля. Для каждой биржи требуется отдельный ключ, который нужно хранить и обновлять отдельно. И большинство из них не предоставляет реальных возможностей для тестирования, поэтому новый код впервые сталкивается с реальными деньгами.

Через Bitsgap используется одна пара ключей, одна схема подписи и демо-площадка, которая ведёт себя так же, как и реальная. Ваш алгоритм также размещается в том же аккаунте, что и ваши GRID-боты, DCA-боты и COMBO-боты, поэтому все ваши позиции отображаются в одном месте, а не в двух разных системах, каждая из которых показывает только часть информации.

Тринадцать минут, шаг за шагом

1. Создайте аккаунт. Тариф Free, без карты. API включён во все тарифы, поэтому здесь ничего обновлять не нужно.

2. Сгенерируйте ключ. Меню аккаунта → API keys → Создать новый ключ. Укажите имя и срок действия, затем нажмите Generate. Срок действия по умолчанию — три года.

3. Сохраните приватный ключ. Он появляется один раз в виде файла PEM. Скачайте его и храните так же, как ключ от биржи. Если вы его потеряете, восстановить его будет невозможно — только заменить.

4. Проверьте, что ваша подпись работает офлайн. В официальных примерах есть тест signing_offline, который не требует ни ключа, ни подключения к сети. Запустите его в первую очередь. Большинство проблем при интеграции связаны с подписью, и этот тест позволяет выявить их до появления других препятствий.

5. Запустите пошаговую инструкцию на демо. Примеры доступны для Go, Rust, Python и TypeScript и по умолчанию используют демо-биржи. Одна команда проведёт вас через подключение, получение рыночных данных, балансы, ордер Spot, ордер Futures и историю ордеров. На любом этапе не используется реальных денег.

6. Подключите его к реальной бирже. Измените всего одну цифру — идентификатор биржи em, и тот же код будет работать в реальном времени.

Как настроить это без необходимости писать код самостоятельно

Вам не нужно создавать интеграцию вручную.

Полная документация по протоколу является общедоступной и машиночитаемой, а рядом с ней размещены четыре полноценных эталонных реализации. Передайте эту документацию любому AI-помощнику для программирования и опишите задачу простыми словами: отслеживать ставку финансирования по трём парам и, когда она становится отрицательной по всем трём, закрыть мои длинные позиции. В ответ вы получите рабочий скрипт, настроенный на демо-площадку, который можно запустить и доработать до того, как он коснётся реального баланса.

Эта медианная продолжительность в 13 минут сохраняется потому, что самые сложные части уже реализованы на четырёх языках, включая подпись Ed25519, канонические строки запроса и логику переподключения, так что вам остаётся только написать торговое правило — и ничего больше.

Рынок продолжает расти быстрее, чем может успеть любой ручной процесс, поэтому время, затрачиваемое на техническую настройку, стало самой дорогой частью подготовки.

Два канала, один список тем

Оба канала используют одни и те же темы с одинаковыми параметрами. REST подходит для программы, которая «просыпается», задаёт один вопрос и снова «засыпает». WebSocket предназначен для той, что остаётся активной и реагирует на события.

Через REST ответ на команду подтверждает, что задача была принята, а не завершена. Результат выполнения приходит через WebSocket-подписку на orders, positions или balance, либо при повторном запросе этих топиков. Счетчик лимита запросов общий для обоих каналов, поэтому смена транспорта не дает дополнительного бюджета.

К чему вы получаете доступ

Сначала вызовите conf_enums. Этот метод возвращает справочные таблицы, которые преобразуют названия бирж в числовые идентификаторы em, ожидаемые всеми остальными топиками — Binance соответствует 2, Binance demo — 101. Топик manual возвращает актуальный каталог всех топиков с их текущими лимитами запросов, чтобы ваш код мог считывать лимиты напрямую, а не прописывать их вручную.

Одно поле, которое стоит использовать с первого дня: apiid. Это ваша собственная метка на ордере, до 250 символов, и она возвращается в каждом последующем отчёте по этому ордеру. Указывайте в ней название стратегии и версию. Когда две ваши программы совершают сделки по одной и той же паре, эта метка — единственное, что позволяет понять, какая из них разместила какой ордер.

Безопасно ли подключать API Bitsgap?

Подключение Bitsgap к вашей бирже остаётся неизменным. Оно предназначено только для торговли и никогда не имело прав на вывод средств. API создаёт отдельное соединение между вашей программой и Bitsgap, подписанное парой ключей Ed25519, которую вы генерируете и контролируете. Ed25519 — это схема электронной подписи, а не пароль: вы храните приватный ключ, Bitsgap сохраняет только публичный, и секретная часть никогда не передаётся по сети. Запросы не могут быть воспроизведены повторно, поскольку каждый из них содержит уникальный nonce и метку времени, действительную в течение десяти секунд. Отзовите ключ — и все открытые сессии немедленно завершатся.

Лимиты в числах

Два из них влияют на то, как вы строите интеграцию. Счетчики лимитов скорости объединены для REST и WebSocket по каждому топику, поэтому опрос в цикле расходует тот же лимит, который необходим для работы живой подписки. А при превышении лимита сообщений на одно соединение сокет закрывается, а не просто отклоняет сообщение, поэтому логика переподключения должна предусматривать задержку, новую авторизационную рамку и повторную подписку.

Три вещи чаще всего приводят к неудаче при первых попытках, именно в таком порядке: несинхронизированные часы, повторно использованный nonce и повторная сериализация тела запроса после его подписи. Полезная нагрузка подписывается побайтно, поэтому изменение порядка ключей или добавление лишнего пробела приводит к другой подписи. Отправляйте точно ту строку, которую вы подписали.

Протестируйте это, не тратя ни копейки

Демо-биржи ведут себя так же, как реальные. Ордеры, исполнения, позиции, балансы — всё это без использования реальных денег. demo_market_reset сбрасывает аккаунт к исходному состоянию, чтобы вы могли довести стратегию до предела и перезапустить её одной командой.

API предоставляется бесплатно на каждом тарифе, включая тариф Free за $0. Не требуется карта, апгрейд или пробный период. Создайте аккаунт, сгенерируйте ключ и начинайте подписывать запросы уже сегодня.

Часто задаваемые вопросы

Что такое Bitsgap API? Публичный API, который позволяет вашей собственной программе получать рыночные данные и размещать сделки на любой бирже, подключённой к вашему аккаунту Bitsgap. Каналы REST и WebSocket используют общий список топиков, аутентификация осуществляется с помощью пары ключей Ed25519, которую вы создаёте и контролируете.

API Bitsgap предоставляется бесплатно? Да. Он включён во все тарифы, включая Free, без дополнительной платы.

Нужно ли уметь программировать? Вам нужно уметь запускать скрипт. Написание скрипта в основном необязательно: протокол и четыре полных эталонных реализации доступны публично, поэтому AI-ассистент по программированию может создать рабочую интеграцию на основе описания на обычном языке.

Какие языки программирования поддерживаются? Любой язык, который может выполнять HTTPS-запросы и вычислять подпись Ed25519. Официальные рабочие примеры доступны на Go, Rust, Python и TypeScript.

Может ли API вывести мои средства? Нет. Bitsgap подключается к вашей бирже с помощью ключа только для торговли, который изначально не имеет прав на вывод средств, и API это не изменяет. Он добавляет отдельный подписанный канал между вашей программой и Bitsgap, который можно отозвать в любой момент.

REST или WebSocket — что выбрать? REST подходит для разовых запросов и запланированных скриптов. WebSocket — для всего, что требует реакции на изменение Цена или отслеживания состояния ордера в реальном времени.

Могу ли я протестировать без реальных денег? Да. Официальные примеры по умолчанию используют демо-биржи, а демо-аккаунт можно сбросить к исходному балансу в любой момент.

Сколько времени занимает настройка? Медианное время от создания API-ключа до первого успешного подписанного запроса составляет 13 минут — по данным среди аккаунтов Bitsgap, которые подключили ключ. [Add measurement window before publish]