# Как создать подключение к бирже
#### ⚠️ ВАЖНО: Это самый первый и обязательный шаг!
Подключение — это связь между программой ISA и биржей, которая позволяет программе взаимодействовать с вашим торговым аккаунтом. \
\
Без подключения вы НЕ сможете:
* Создавать торговых ботов
* Получать данные о балансе
* Размещать ордера на бирже
* Мониторить активные позиции
Подключение использует API ключи биржи для безопасной авторизации и выполнения торговых операций от вашего имени.\
#### Поддерживаемые биржи
На данный момент программа ISA поддерживает: Bybit
* Spot (Спотовая торговля)
* USDT-Margined Futures (Фьючерсы USDT)
### Пошаговая инструкция по созданию подключения
#### Этап 1. Получение API ключей на бирже
Прежде чем создавать подключение в программе, вам нужно получить API ключи на самой бирже.
**Для Bybit:**
1. Авторизуйтесь на сайте Bybit (bybit.com)
2. Перейдите в "Учетная запись" → "API" → "Создать новый ключ"
3. Выберите тип API:
* Для спотовой торговли: выберите "Spot"
* Для фьючерсов: выберите "Unified Trading Account" или "Derivatives"
1. Придумайте название для ключа (например: "ISA Bot")
2. Установите права доступа (permissions):
* ✅ Чтение (Read) — обязательно
* ✅ Торговля (Trade) — обязательно
* ❌ Вывод средств (Withdraw) — НЕ включайте для безопасности
1. ВАЖНО: Для дополнительной безопасности настройте IP Whitelist (если нужно)
2. После создания биржа покажет вам:
* API Key (публичный ключ) — длинная строка символов
* Secret Key (секретный ключ) — еще одна длинная строка
1. ⚠️ **КРИТИЧЕСКИ ВАЖНО: Скопируйте и сохраните Secret Key — он показывается только один раз! После закрытия окна вы больше не сможете его увидеть, придется создавать новый ключ.**
***
#### Этап 2. Создание подключения в программе ISA
После получения API ключей переходим к настройке в программе:
* Откройте программу ISA
* В верхнем меню нажмите "Подключения"
* Нажмите кнопку "Добавить подключение" или "+"
* Откроется окно "Добавление подключения" — заполните все поля:
***
**Поле 1: Имя подключения**
"Придумайте имя подключению"
* Это произвольное название для вашего удобства
* Примеры: Bybit\_Основной, Binance\_Test, Bybit\_Futures\_Main
* Название помогает различать подключения, если у вас их несколько
***
**Поле 2: Тип подключения**
"Выберите подключение из списка"\
Выберите биржу и тип рынка из выпадающего списка:
* ByBit Spot — спотовая торговля на Bybit
* ByBit USDT Margined Futures — фьючерсы USDT на Bybit
**Важно:** Выбирайте тот тип, под который создавали API ключи на бирже!
***
**Поле 3: Публичный API ключ**
"Введите ваш публичный API ключ"
* Вставьте API Key (публичный ключ), который вы получили на бирже
* Пример формата: AbCd1234EfGh5678IjKl9012MnOp3456
* Это длинная строка из букв и цифр
***
**Поле 4: Секретный API ключ**
"Введите ваш секретный API ключ"
* Вставьте Secret Key (секретный ключ) с биржи
* Пример формата: ZyXw9876VuTs5432RqPo1098NmLk5678
* Храните этот ключ в секрете! Не передавайте никому
***
**Опция: Демо-режим**
"Демо-режим" (галочка)
* ✅ Включено — подключение к демо счету биржи
* Используется для тестирования стратегий без реальных денег
* Требуются специальные API ключи от демо-аккаунта
* ❌ Выключено — подключение к реальной бирже (mainnet)
* Торговля на реальные деньги
* Используются обычные API ключи
Для новичков рекомендуется сначала протестировать на демо-режиме!
***
**Опция: Отображать в нижней строке**
"Отображать состояние в нижней строке"
* ✅ Включено — информация о подключении (баланс, пинг) будет отображаться в нижней панели программы
* Удобно для быстрого мониторинга состояния подключения
***
1. Проверьте все данные и нажмите кнопку "Сохранить"
2. Если всё настроено правильно:
* Появится уведомление: "Команда выполнена успешно! Подключение (ИМЯ) добавлено"
* Подключение появится в таблице подключений
***
#### Этап 3. Включение подключения
После создания подключения его нужно включить, чтобы оно заработало:
1. В таблице подключений найдите ваше созданное подключение
2. В колонке "Управление" переведите переключатель в положение "ВКЛ"
3. Программа установит соединение с биржей
4. В колонке "Статус" должно появиться:
* "Активен" — всё работает ✅
* Время пинга (например: 100.00ms) — скорость связи с биржей
Если статус "Ошибка":
* Проверьте правильность API ключей
* Убедитесь что права доступа настроены корректно
* Проверьте интернет-соединение
* Посмотрите логи (кнопка "Показать логи" в строке подключения)
***
#### Возможные ошибки и их решение
❌ "Invalid API key" / "Неверный API ключ"
* Проверьте правильность скопированного API Key
* Убедитесь что не скопировали лишние пробелы в начале/конце
❌ "Invalid signature" / "Неверная подпись"
* Проверьте правильность Secret Key
* Попробуйте пересоздать API ключи на бирже
❌ "IP not allowed" / "IP не разрешен"
* Если на бирже включен IP Whitelist, добавьте ваш IP адрес в список разрешенных
* Или отключите IP Whitelist на бирже (менее безопасно)
❌ "Insufficient permissions" / "Недостаточно прав"
* API ключ не имеет нужных прав (Read + Trade)
* Пересоздайте ключ с правильными правами доступа
❌ "Подключение активно"
* Вы пытаетесь изменить активное подключение
* Сначала выключите подключение, затем редактируйте
***
#### Что дальше?
После успешного создания и включения подключения вы можете:\
✅ Создавать торговых ботов на этом подключении\
✅ Просматривать баланс на бирже\
✅ Мониторить активные позиции и ордера\
✅ Запускать стратегии автоматической торговли
***
#### Рекомендации по безопасности
🔒 НЕ давайте API ключам права на вывод средств (Withdraw)\
🔒 Используйте уникальные API ключи для каждого приложения\
🔒 Храните Secret Key в секрете — это как пароль от аккаунта\
🔒 Регулярно обновляйте ключи (раз в 1-3 месяца)\
🔒 Включайте IP Whitelist если работаете с одного компьютера\
🔒 Сначала тестируйте на демо-режиме с небольшими суммами
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ispecalgo.com/isa-algoterminal/kak-sozdat-podklyuchenie-k-birzhe.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.