Рассмотрим пример конфигурации.
Что мы видим в данном примере:
- На бирже имеется два аккаунта (счета) — Основной и Субаккаунт. Они друг от друга не зависят, это как бы две отдельные биржи. Вначале у всех пользователей биржи имеется только основной счёт, а субаккаунты создаются по желанию.
- Каждый биржевой аккаунт делится на два счета уровнем ниже. Счёт финансирования — для хранения средств, Единый торговый счёт — для торговых операций. Наши боты заходят только на один, строго определённый торговый счёт, и больше никуда.
- Чтобы боты (или другие приложения) могли попасть на торговый счёт, на нём сперва надо открыть доступ — создать API-ключ. Можно один, а можно несколько.
- В нашем примере на счете «Основной» имеются три разных API-ключа для Veles и один для дневника трейдера Traders Diaries.
- На счёте «Субаккаунт 1» имеются два разных API-ключа для Veles и один для дневника трейдера Traders Diaries.
- В кабинете Veles нужно создать промежуточный связующий элемент — Привязку на API-ключ от биржи. И в настройках бота будет выбираться именно Привязка. Привязки можно редактировать — сохранять в них данные от другого API-ключа (если срок годности старого ключа истёк, например).
- Если конкретный API-ключ имеет разрешения на два вида торговли — и на спот, и на фьючерсы (API-1, API-4, API-5), то к нему можно создать и спотовую, и фьючерсную Привязку.
- Если конкретный API-ключ имеет разрешения только на один вид торговли (API-2 и API-3) — то и Привязку к нему можно создать только такого точно вида.
- В кабинете Veles все боты имеют настройку на одну из созданных Привязок. Эту настройку можно в боте изменить — и бот отправится торговать по другой Привязке. А другая Привязка либо будет указывать на другой торговый счёт, либо иметь другие блокировки.
- К одному кабинету Veles можно подключить несколько бирж. Счета в них могут быть организованы немного по-другому, но принцип соединения будет тот же. На торговом счете создается API-ключ, его данные сохраняются в Привязке, а в боте выбирается нужная Привязка.
А теперь поясним немного подробнее.
API-ключ — это объект, создающийся и хранящийся на бирже. Это набор данных , включающий в себя «логин+пароль+разрешения», только он создаётся не для человека, а для какой-либо программы. В данном случае — для сервиса Veles, чтобы бот мог входить на ваш торговый счёт и выставлять от вашего имени ордера. При создании ключей нужно выбрать опцию «Привязать к стороннему приложению», указать «Veles» в качестве выбранного приложения, и никакая другая программа или сайт по этому ключу уже на биржу не зайдёт, даже если будет знать «логин+пароль».
Пароль (секретная часть API ключа) отображается при его создании вручную только один раз — в готовом API ключе его просмотреть уже не получится. Поэтому нужно сохранить его в базе паролей, если вы планируете использовать этот API ключ в разных Привязках (например, на основном сайте Veles и на бета-стенде).
А при использовании процедуры быстрого подключения секретная часть не показывается вообще, то есть такой ключ прописать в других Привязках уже никак не получится.
Один счёт на бирже может иметь несколько API-ключей, как для разных сервисов, так и для одного и того же. Неиспользуемые ключи рекомендуется удалять.
Привязка в Veles к данному API-ключу — это объект, хранящийся на сайте Veles, то есть компонент настройки для бота, который указывает, на какой биржевой счёт боту идти торговать.
Одну подготовленную Привязку Вы можете выбрать в нескольких ботах — и все они пойдут на один торговый счёт работать.
То, что у вас отображено в профиле Veles в разделе «API ключи» (страница https://veles.finance/cabinet/account/api) — это Привязки.
Сами же API-ключи находятся на бирже. Например, на Bybit:
Привязка может быть либо только фьючерсной, либо только спотовой. API-ключ, однако, может содержать разрешения на оба вида торговли. То есть ключ на бирже может быть один, а привязки в профиле на него будут две разные — спот и фьючерсы (как в примере на данном скриншоте, здесь обе привязки — с именами «Bybit Spot NLYT», и «Bybit Futures NLYT» — указывают на один и тот же API-ключ, имя которого начинается на «NLYT»).
Комплект «API-ключ + Привязка» можно создавать либо через так называемое «быстрое подключение» (работает для главного аккаунта биржи), либо полностью вручную (требуется для субаккаунтов, так как быстрое подключение не поддерживается).
Если вы меняете ключ на бирже, а привязка у вас уже используется в двадцати ботах — вам затем достаточно отредактировать одну эту привязку, подставить в неё новые данные от API ключа. И все боты будут автоматом использовать новые данные, редактировать каждый из них не нужно.
Когда API-привязка создана правильно и указывает на нужный вам счёт, то бот, открытый в редакторе, отображает в поле «БАЛАНС» сумму обнаруженных свободных средств в нужной ему монете («Сумма к переводу») на соответствующем торговом счёте. Торговый счёт — это «Фьючерсы (Деривативы)», «Спот» либо «Единый торговый» аккаунт на бирже. Счёт финансирования — это не торговый счет, бот к нему не подключается. При этом бот видит не все средства, а только ту валюту, которая нужна ему для торговли (стейблкоин или нужная монета, если бот на споте в шорт).
Сама же биржа на странице обзора Активов показывает вам сумму всех активов, сконвертированную по текущему курсу в USD или другую фиатную валюту (рубли, например, и это настроено в вашем профиле на бирже), и текущие незафиксированные прибыли и убытки. То есть график на этой странице — это не график результатов торговли бота. И сумма средств на Едином торговом — это не то, что доступно боту в настоящий момент.
Приглядитесь — это число (в USD) постоянно меняется, потому что меняются курсы монет и PnL позиций, например, и происходит пересчёт и обновление.
Если ваши средства находятся на нужном торговом счёте, но бот видит сумму меньше, либо вообще «0» — то надо перейти на биржу, на сам торговый счёт (дойти до страницы с графиками монет), и проверить — какие там есть открытые позиции и выставленные ордера. Открытые минусовые позиции забирают к себе (в поддерживающую маржу) свободные средства с баланса, вплоть до нуля (и потом возвращают их, когда выходят в профит). А при выставлении усредняющих ордеров биржа также резервирует средства из свободной маржи, и затем либо возвращает их на баланс (при отмене ордера), либо эта сумма переходит в объём сделки (если ордер исполняется).
Примечание. Сумма средств, которую вы видите в профиле Veles в разделе Баланс — это не средства для торговли, а отдельный, внутренний кошелёк. Он служит исключительно для оплаты сервисной комиссии и подписок на нашей платформе.
