Справка Alphafamilia Algo

BingX: спот и фьючерсы USDT-M

Стратегия торгует на BingX на споте и бессрочными фьючерсами USDT-M по тем же правилам, что и на Binance: вход, усреднения, ТП на весь объём; на фьючерсах — плечо, лонг и шорт, funding, ликвидация (Фьючерсы). Эта страница — о том, что у BingX иначе: счета, ключ, учебный счёт VST, перевод денег и несколько особенностей биржи.

Аккаунт и субаккаунт

  • Нужен верифицированный аккаунт BingX; для фьючерсных стратегий — открытый раздел бессрочных фьючерсов (Perpetual Futures).
  • Для стратегий лучше завести отдельный субаккаунт и выпустить ключ на нём: стратегии видят только его деньги, а ваша ручная торговля на основном аккаунте им не мешает. Субаккаунты создаются в BingX в разделе аккаунта («Sub-accounts»).
  • Спот и фьючерсы одного аккаунта — два подключения: «BingX спот» и «BingX фьючерсы USDT-M». Ключ может быть один и тот же (с правами на оба рынка), но вводится для каждого подключения (Подключения и сейф).

Ключ и адрес сервера

Настройка ключа на BingX Что нужно
Чтение (Read) Включено (у BingX включено всегда)
Spot Trading Включено — для подключения «BingX спот»
Perpetual Futures Trading Включено — для подключения «BingX фьючерсы USDT-M»
Withdrawal (вывод), переводы Выключены — ключ с правом вывода не принимается
IP whitelist Только адрес сервера Alphafamilia Algo
  1. Узнайте адрес сервера: в приложении, «Профиль» → «Настройки» → «Подключения к биржам» → «+ Новое подключение» → рынок BingX → «Дальше: ключ →». Адрес показан над полями ключа с кнопкой «Копировать»; там же памятка и ссылка на страницу ключей BingX.
  2. На BingX откройте профиль → «API Management» → «Create API». Подтвердите создание кодами двухфакторной защиты. Скопируйте API Key и Secret Key — Secret Key биржа показывает один раз.
  3. В правах ключа («Edit») включите «Spot Trading» и/или «Perpetual Futures Trading». Вывод и переводы оставьте выключенными.
  4. Впишите адрес сервера в список IP ключа (IP whitelist) и сохраните.

Что проверяет приложение, нажав «Проверить ключ»: торговля разрешена, вывод запрещён, право на рынок подключения (спот или фьючерсы) и есть ли список IP. Без списка IP ключ примут с предупреждением; с правом вывода — не примут.

Новое подключение «BingX фьючерсы USDT-M» на учебном счёте VST, шаг 2: памятка BingX, адрес сервера, ключ проверен

Важно. Сервер ходит на BingX только по адресу IPv4 — именно его и показывает приложение. Если адрес сервера не вписан в список IP ключа, проверка ответит «Адрес сервера … не входит в список IP этого ключа — добавьте его в настройках ключа на бирже и проверьте снова». После переезда сервера на другой адрес ключи BingX нужно обновить — администратор системы предупредит.

Важно. Ключ и секрет вводите только в форму приложения. Приложение принимает части ключа длиной 32–128 знаков без пробелов; остальное проверяет сама биржа.

Учебный счёт VST

У BingX есть учебная торговля фьючерсами — счёт с виртуальными USDT, которые биржа называет VST. Это среда «учебный счёт VST» подключения «BingX фьючерсы USDT-M»: тот же ключ, те же контракты, настоящих денег нет.

  • Выберите рынок «BingX фьючерсы USDT-M» и среду «учебный счёт VST». Ключ проверяется на учебном счёте; «Добавить» не спрашивает про настоящие деньги.
  • Валюта котировки у стратегий такого подключения называется VST — это учебные USDT.
  • Учебного спота у BingX нет: у подключения «BingX спот» среда только реальная. Если вы пришли кнопкой «Для тестов», под средой жёлтым: «У этого рынка нет учебной среды — здесь только настоящие деньги.». Для проверки спота используйте маленький бюджет (например, 20 USDT на BTC-USDT): 200 USDT в чек-листе «Первые шаги» — только порог подсказки, а не правило биржи. Хватит ли суммы, покажет форма стратегии: части меньше минимума биржи она сохранить не даст.

Перевод денег между счетами

Деньги на BingX лежат на нескольких счетах: пополнение приходит на счёт Fund, спотовая торговля идёт со спотового счёта, фьючерсная — со счёта бессрочных фьючерсов. Стратегии видят только спотовый и фьючерсный счета: строка «Свободно на счёте» под бюджетом в форме стратегии и предупреждение «Свободно на счёте … бюджет …» считаются по ним.

Переведите нужную сумму на BingX: «Активы» → «Перевод» (Transfer), со счёта Fund на спотовый или фьючерсный. Ключ стратегии переводами не занимается — право переводов у него выключено.

Подготовка фьючерсного счёта

Стратегия торгует фьючерсами только в Hedge Mode с кросс-маржой и одной валютой маржи. На BingX Hedge Mode стоит по умолчанию. Если режим другой, стратегия ждёт и показывает причину на экране стратегии:

  • «Счёт в режиме One-way: включите Hedge Mode — на BingX: Фьючерсы → настройки (шестерёнка) → Position Mode». Режим один на весь аккаунт, переключается только без открытых позиций и заявок.
  • «Включён мультиактивный режим: выключите Multi-Assets Mode — на BingX: Фьючерсы → настройки → Asset Mode → Single-Asset». На учебном счёте VST этого режима нет.
  • «Маржа пары изолированная: переключите на Cross — на BingX в панели заявки контракта (Isolated / Cross)».

Плечо на BingX одно на контракт, стратегия ставит его обеим сторонам (лонг и шорт) — только когда по контракту нет ни позиции, ни заявок, как на Binance (Плечо).

Отличия от Binance

  • Рыночная покупка на споте — на сумму. Стратегия отправляет сумму в USDT (количество по плану × лучшая цена продажи), а биржа покупает на неё столько монет, сколько получится. Купленное стратегия учитывает как есть; без текущей цены заявка не отправляется — стратегия попробует на следующем шаге.
  • Комиссия. На споте биржа берёт комиссию в полученном активе (при покупке — в монете), на фьючерсах — в USDT (на VST — в VST). Для плана ТП стратегия читает у биржи ставку maker вашего счёта (ТП — лимитная заявка), как на Binance; вход и усреднения учитываются по комиссии, которую биржа действительно списала. Чтобы после комиссии монетой на ТП осталось плановое количество, спотовая покупка (вход, усреднение, ручная) берёт на шаг количества больше.
  • Биржа молча отрезает лишние знаки цены и количества. Стратегия сверяет записанное биржей с отправленным; если они разошлись (шаги пары изменились), стратегия уходит в аварию с причиной «у инструмента изменились правила (лот, тикер или точность)» — проверьте правила пары и нажмите «Продолжить цикл» или «Начать новый цикл».
  • Лимиты запросов. BingX считает запросы каждого метода в секунду на аккаунт (заявки — 10 в секунду). ТП после исполнения ставится первым; новое усреднение может подождать один шаг. При «слишком часто» — пауза аккаунта, при бане адреса (несколько минут) — сообщение в Telegram всем, кто торгует на BingX. Иногда BingX закрывает на время (до 15 минут) только выставление заявок, а снятие оставляет. Пока так, стратегия не снимает свой ТП ради замены: прежний ТП стоит на бирже, а новый — на всю позицию после усреднения — ставится, как только биржа снова принимает заявки.
  • Биржа отвечает с опозданием. Ещё 10–40 секунд после исполнения BingX может отвечать «заявки нет». Такой ответ стратегия первые 10 минут считает неизвестным исходом: ждёт сделку и по этой роли ничего не выставляет заново. Сделки (на споте и фьючерсах) появляются в истории биржи тоже с опозданием — стратегия перечитывает последние 10 минут и учитывает каждую сделку один раз, когда она появится.
  • Заявка, отменённая самой биржей. BingX отменяет заявки стратегии, например когда вы закрыли позицию вручную. Об этом стратегия узнаёт из истории заявок. Спрашивать биржу «а где заявка?» по номеру можно лишь ограниченное число раз: если «заявки нет» отвечать слишком часто, BingX на время запрещает счёту такие вопросы. Поэтому стратегия не спрашивает о пропавшей заявке каждый шаг, а в паузах между вопросами смотрит историю заявок; число таких вопросов держится ниже лимита биржи.
  • Память биржи. История заявок — 7 дней, поиск заявки по номеру — 2 часа. После простоя дольше 7 дней стратегия не угадывает исход потерянной заявки — авария со сверкой.
  • Поток событий. На фьючерсах биржа сама сообщает об исполнениях. По умолчанию (режим сверки) стратегии учитывают сделки по истории сделок биржи, как раньше, а сделки из потока только сравниваются с ней; расхождения записываются в журнал сервера (последний знак комиссии и время в пределах секунды — не расхождение, а только счётчик). После недели без расхождений администратор системы может включить режим, в котором сделка из потока сразу считается фактом (ТП ставится быстрее), а история сделок читается для сверки раз в 5 минут и по поводу — поздняя сделка, обрыв потока. При расхождении с биржей стратегия перестаёт доверять потоку и возвращается к истории сделок. Это настройка сервера ([service] bingx_fills_from, «Настройки сервера» в руководстве администратора); fills_from = "rest" выключает факты потоков всех бирж. На споте стратегии поток событий не используют: спотовые стратегии BingX опрашивают биржу, ТП — в пределах шага стратегии; незнакомые сообщения биржи в потоке пропускаются и поток не обрывают. Журнал сырых событий потока ([diagnostics]) включается только по просьбе разработчика; ключей, listenKey и подписей в нём нет.
  • Сделка ТП с опозданием. BingX иногда показывает сделку через несколько минут. Пока биржа говорит, что ТП исполнен, стратегия ждёт его сделку до 12 минут и в аварию «на счёте меньше актива, чем учтено» не уходит (Аварии и сбои). Сделка, чью заявку биржа ещё не показала, приходит позже и не теряется; сделки исполненной заявки стратегия дочитывает через 2 минуты.
  • Стратегии одного счёта могут торговать друг с другом: одна сделка — две строки, каждая стратегия учитывает свою. Сделку, которую биржа так и не связала ни с одной заявкой стратегий, стратегия не учитывает и сообщает «Сделка не отнесена ни к одной стратегии»; если биржа не отдаёт сделки какой-то секунды 10 минут — «Биржа не показывает часть сделок» (Сообщения).
  • Не предлагаются контракты BingX на акции, валюты, индексы и сырьё: у них своё расписание и другие правила.
  • Отчёты. Площадки в группировке — «BingX» (спот) и «BingX фьючерсы». Курсы для пересчёта итога берутся с вашей первой реальной криптобиржи: с Binance, если она подключена, иначе с BingX — под сводкой написано, откуда курс.

Если что-то не так

Что видно Что это значит
«Биржа не принимает этот ключ.» Ключ или секрет неверные, ключ удалён или не подписан
«Адрес сервера … не входит в список IP этого ключа …» Впишите адрес сервера в IP whitelist ключа на BingX
«Фьючерсы не разрешены» / «Спотовая торговля не разрешена» У ключа нет права на рынок подключения — включите «Perpetual Futures Trading» или «Spot Trading»
«Свободно на счёте … бюджет …: части … не выставятся» в форме стратегии Деньги лежат на счёте Fund — переведите их на спотовый или фьючерсный счёт
Стратегия ждёт с причиной про Hedge Mode / Cross / Multi-Assets Переключите режим на BingX (см. выше); стратегия ничего не переключает сама
«BingX заблокировал адрес сервера» в Telegram Биржа на несколько минут закрыла адрес сервера: ждут все стратегии на BingX, заявки на бирже остаются; стратегия продолжит сама

Дальше: Bybit