Что такое API ключ
API ключ — это специальный объект, создаваемый и хранящийся на бирже. По сути, это «логин + пароль + разрешения», но предназначенный не для человека, а для программы. В нашем случае — для сервиса Veles, чтобы боты могли входить на ваш торговый счёт и выставлять от вашего имени ордера.
Привязка в Veles
Заголовок раздела «Привязка в Veles»Привязка — это элемент в кабинете Veles, «пропуск на биржу», который указывает:
- через какой API ключ бот будет торговать,
- какой тип торговли разрешён (только Spot или только Futures).
Одну и ту же привязку можно использовать в нескольких ботах, и они все будут работать через один торговый счёт.
👉 В разделе API ключи в вашем профиле отображаются именно привязки.
А вот сами API-ключи создаются и хранятся на бирже (пример на Bybit):
Привязка в Veles всегда имеет строгий тип — фьючерсная или спотовая. При этом сам API-ключ на бирже может быть универсальным и содержать разрешения на оба вида торговли. В таком случае в Veles можно создать две разные привязки к одному ключу — для спота и для фьючерсов.
Создание привязки к бирже
Заголовок раздела «Создание привязки к бирже»Комплект «API ключ + Привязка» можно создать двумя способами:
- Быстрое подключение — работает для основного аккаунта некоторых бирж.
- Ручное подключение — необходимо для субаккаунтов или когда быстрое подключение недоступно.
При ручном подключении вы сначала создаёте ключ на бирже, а затем вручную добавляете привязку в Veles.
⚡ Важно: если вы замените ключ на бирже, достаточно отредактировать одну привязку в Veles — и все ваши боты, использующие её, автоматически перейдут на новые данные.
При создании API-ключей на бирже:
- выбирайте опцию «Привязать к стороннему приложению» и указывайте «Veles», если это возможно;
- если такой опции нет — задайте список доверенных IP-адресов (см. ниже).
Пароль (секретная часть API-ключа) отображается только один раз при создании ключа. Сохраните его в менеджере паролей.
⚠ При быстром подключении секретная часть вообще не отображается и не может быть использована повторно.
Пример API подключения
Заголовок раздела «Пример API подключения»Что видно на примере Bybit:
- У пользователя есть основной аккаунт и субаккаунт (они независимы, как два разных счёта).
- Внутри аккаунта есть разделение на счёт финансирования и торговый счёт. Боты работают только с торговым счётом.
- Для доступа создаются API-ключи (один или несколько).
- Ключ может иметь разные разрешения — только на спот, только на фьючерсы или на оба вида торговли.
- В Veles создаются привязки к этим ключам, которые указываются в настройках ботов.
Таким образом, бот → Привязка → API ключ → Биржевой торговый счёт.
Часто задаваемые вопросы
Заголовок раздела «Часто задаваемые вопросы»1. Как переделать фьючерсного бота в спотового?
Заголовок раздела «1. Как переделать фьючерсного бота в спотового?»Просто выберите в его настройках спотовую привязку. Настройка «Плечо» исчезнет. На споте ликвидаций нет, но потребуется заранее докупить немного монеты (≈0.2% от депозита).
2. Как переделать спотового бота во фьючерсного?
Заголовок раздела «2. Как переделать спотового бота во фьючерсного?»Выберите фьючерсную привязку. Появится настройка «Плечо». Обязательно оцените просадки (МПУ) через бэктест, чтобы правильно рассчитать маржу.
3. Почему в редакторе бота не видно моих средств?
Заголовок раздела «3. Почему в редакторе бота не видно моих средств?»Бот показывает баланс только на торговом счёте и только в нужной для торговли валюте. Если баланс нулевой, проверьте:
- не зарезервированы ли средства под открытые позиции или ордера,
- действительно ли средства находятся на торговом счёте, а не на счёте финансирования.
Список доверенных IP для API-ключей
Заголовок раздела «Список доверенных IP для API-ключей»На некоторых биржах можно выбрать приложение Veles — тогда срок действия ключа будет неограниченным. На других нужно указать список доверенных IP-адресов:
5.9.195.106 5.9.195.107 5.9.195.108 5.9.195.109 5.9.195.110 5.9.200.58 5.9.200.59 5.9.200.60 5.9.200.61 5.9.200.62 88.198.100.162 88.198.100.163 88.198.100.164 88.198.100.165 88.198.100.166
Что делать, если срок API-ключа истёк?
Заголовок раздела «Что делать, если срок API-ключа истёк?»- На некоторых биржах (например, Binance) ключи по умолчанию действуют до 3 месяцев.
- Чтобы продлить срок: измените любое ограничение → сохраните → верните настройки обратно → сохраните снова.
- Если биржа поддерживает выбор приложения «Veles» при создании ключа, выберите его — тогда срок действия будет неограниченным.
Замена реквизитов API-ключа в привязке
Заголовок раздела «Замена реквизитов API-ключа в привязке»Если у вас уже есть боты на привязке, менять каждый из них не нужно. Достаточно заменить данные в привязке:
- Создайте новый API-ключ на бирже.
- Перейдите в раздел API ключи Veles.
- Нажмите Редактировать на нужной привязке.
- Вставьте новые данные от API-ключа.
Боты продолжат работу через новый ключ без ошибок и остановки сделок.