Перейти к содержимому

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

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

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

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

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

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

Список API-ключей в Кабинете

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

Список API-ключей на бирже

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

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

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

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

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

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

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

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

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

Схема использования ключей

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

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

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

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

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

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

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

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

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

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

Заголовок раздела «3. Почему в редакторе бота не видно моих средств?»

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

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

Биржевой баланс

На некоторых биржах можно выбрать приложение 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

Список IP адресов

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

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

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

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

API редактирование