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

> Как устроен доступ ботов Veles к вашему биржевому счёту через API ключи и привязки.

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

## Привязка в Veles

**Привязка** — это элемент в кабинете Veles, «пропуск на биржу», который указывает:
- через какой API ключ бот будет торговать,
- какой тип торговли разрешён (только **Spot** или только **Futures**).

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

👉 В разделе [API ключи](https://veles.finance/cabinet/account/api) в вашем профиле отображаются именно **привязки**.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### 2. Как переделать спотового бота во фьючерсного?
Выберите **фьючерсную привязку**. Появится настройка «Плечо».
Обязательно оцените просадки (МПУ) через [бэктест](https://help.veles.finance/ru/platform/components/backtests/), чтобы правильно рассчитать маржу.

### 3. Почему в редакторе бота не видно моих средств?
Бот показывает баланс **только на торговом счёте** и только в нужной для торговли валюте.
Если баланс нулевой, проверьте:
- не зарезервированы ли средства под открытые позиции или ордера,
- действительно ли средства находятся на торговом счёте, а не на счёте финансирования,
- иногда средства есть, но не видны, и бот торгует нормально (варианты: токены BNFCR на бирже Binance, средства из займа на бирже Bybit, монеты из резерва обеспечения),
- временные ограничения синхронизации с биржей могут тоже давать такой эффект.

:::note[Важно]
Баланс в кабинете 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
```

В некоторых случаях требуется перечисление адресов через запятую:

```
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 месяцев.
- Чтобы продлить срок: измените любое ограничение → сохраните → верните настройки обратно → сохраните снова.
- Другой вариант: откройте ключ на бирже для редактирования, добавьте доверенные IP-адреса, сохраните.
- Если биржа поддерживает выбор приложения «Veles» при создании ключа, выберите его — тогда срок действия будет **неограниченным**.

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

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

1. Создайте новый API-ключ на бирже по **ручной процедуре** (чтобы получить и скопировать публичную и секретную часть ключа).
2. Перейдите в раздел [API ключи Veles](https://veles.finance/cabinet/account/api).
3. Нажмите **Редактировать** на нужной привязке.
4. Вставьте новые данные от API-ключа в привязку и сохраните её.

Боты продолжат работу через новый ключ **без ошибок и остановки сделок**.
Если же остановка произошла ранее - стартуйте бота и выберите «Перезапустить сделку».