Что такое API ключ

API ключ — это специальный объект, создаваемый и хранящийся на бирже. По сути, это «логин + пароль + разрешения», но предназначенный не для человека, а для программы. В нашем случае — для сервиса Veles, чтобы боты могли входить на ваш торговый счёт и выставлять от вашего имени ордера.

Привязка в Veles

Привязка — это элемент в кабинете Veles, «пропуск на биржу», который указывает:

• через какой API ключ бот будет торговать,
• какой тип торговли разрешён (только Spot или только Futures).

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

👉 В разделе API ключи в вашем профиле отображаются именно привязки.

А вот сами API-ключи создаются и хранятся на бирже (пример на Bybit):

Привязка в Veles всегда имеет строгий тип — фьючерсная или спотовая. При этом сам API-ключ на бирже может быть универсальным и содержать разрешения на оба вида торговли. В таком случае в Veles можно создать две разные привязки к одному ключу — для спота и для фьючерсов.

Создание привязки к бирже

Комплект «API ключ + Привязка» можно создать двумя способами:

1. Быстрое подключение — работает для основного аккаунта некоторых бирж.
2. Ручное подключение — необходимо для субаккаунтов или когда быстрое подключение недоступно.

При ручном подключении вы сначала создаёте ключ на бирже, а затем вручную добавляете привязку в Veles.

⚡ Важно: если вы замените ключ на бирже, достаточно отредактировать одну привязку в Veles — и все ваши боты, использующие её, автоматически перейдут на новые данные.

При создании API-ключей на бирже:

• выбирайте опцию «Привязать к стороннему приложению» и указывайте «Veles», если это возможно;
• если такой опции нет — задайте список доверенных IP-адресов (см. ниже).

Пароль (секретная часть API-ключа) отображается только один раз при создании ключа. Сохраните его в менеджере паролей.

⚠ При быстром подключении секретная часть вообще не отображается и не может быть использована повторно.

Пример API подключения

Что видно на примере Bybit:

• У пользователя есть основной аккаунт и субаккаунт (они независимы, как два разных счёта).
• Внутри аккаунта есть разделение на счёт финансирования и торговый счёт. Боты работают только с торговым счётом.
• Для доступа создаются API-ключи (один или несколько).
• Ключ может иметь разные разрешения — только на спот, только на фьючерсы или на оба вида торговли.
• В Veles создаются привязки к этим ключам, которые указываются в настройках ботов.

Таким образом, бот → Привязка → API ключ → Биржевой торговый счёт.

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

1. Как переделать фьючерсного бота в спотового?

Просто выберите в его настройках спотовую привязку. Настройка «Плечо» исчезнет. На споте ликвидаций нет, но потребуется заранее докупить немного монеты (≈0.2% от депозита).

2. Как переделать спотового бота во фьючерсного?

Выберите фьючерсную привязку. Появится настройка «Плечо». Обязательно оцените просадки (МПУ) через бэктест, чтобы правильно рассчитать маржу.

3. Почему в редакторе бота не видно моих средств?

Бот показывает баланс только на торговом счёте и только в нужной для торговли валюте. Если баланс нулевой, проверьте:

• не зарезервированы ли средства под открытые позиции или ордера,
• действительно ли средства находятся на торговом счёте, а не на счёте финансирования.

Важно

Баланс в кабинете Veles — это внутренний кошелёк для оплаты комиссии и подписок. Для торговли используются средства на биржевых счетах.

Список доверенных 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-ключа истёк?

• На некоторых биржах (например, Binance) ключи по умолчанию действуют до 3 месяцев.
• Чтобы продлить срок: измените любое ограничение → сохраните → верните настройки обратно → сохраните снова.
• Если биржа поддерживает выбор приложения «Veles» при создании ключа, выберите его — тогда срок действия будет неограниченным.

Замена реквизитов API-ключа в привязке

Если у вас уже есть боты на привязке, менять каждый из них не нужно. Достаточно заменить данные в привязке:

1. Создайте новый API-ключ на бирже.
2. Перейдите в раздел API ключи Veles.
3. Нажмите Редактировать на нужной привязке.
4. Вставьте новые данные от API-ключа.

Боты продолжат работу через новый ключ без ошибок и остановки сделок.