Торговля через API на Upscale: как подключить бота к челленджу
На Upscale появилась опция API Trading. Она дает программный доступ к челленджу, так что к счету можно подключить торгового бота, собственный скрипт или готовый алгоритмический движок. Опция доступна на счетах номиналом от $10,000, а также на демо-счете. Ниже разбираем, как подключить API, как выглядит первый запуск кода, по каким правилам работает счет с опцией и кому она действительно нужна.
Что такое API Trading на Upscale
API (Application Programming Interface) — это способ управлять счетом без интерфейса терминала, с помощью запросов из кода. Программа отправляет запрос вроде «открой позицию» или «покажи текущие позиции», а сервер Upscale исполняет его и возвращает ответ. Все, что трейдер делает руками в терминале, алгоритм делает сам, по заданным правилам и без участия человека. Такой подход называют алгоритмической торговлей.
Внутри торгового алгоритма может быть что угодно: индикаторы технического анализа, парсер новостей, экономический календарь или комбинация этих источников. Но на выходе у любой стратегии одно и то же действие — ордер. Чтобы торговать через API, программе по сути нужны две вещи: отправлять ордера и следить за состоянием счета, прежде всего за просадкой. Остальное — просмотр истории, массовое закрытие позиций и прочие функции — детали реализации.
Для каких задач подходит опция
Первый сценарий — торговый бот на собственной стратегии. Трейдер формализует правила входа и выхода, а скрипт следит за рынком и открывает сделки, когда условия совпадают. Алгоритм не устает, не отвлекается и может работать, пока трейдер спит.
Второй сценарий подходит тем, у кого уже есть алгоритмический движок. Upscale подключается к нему как еще одна площадка для исполнения сделок: логика стратегии остается прежней, меняется только адрес, куда уходят ордера.
Третий сценарий — контроль риска и аналитика. Через API можно получать данные о счете, позициях и ордерах в реальном времени и собирать собственную торговую телеметрию. Можно также настроить автоматическое закрытие позиций, если счет приближается к лимиту просадки. Это важно, потому что лимиты на Upscale считаются с учетом нереализованного PnL: убыточная открытая позиция уменьшает баланс сразу, а не в момент закрытия. Такой контроль снижает риск, но не гарантирует результат: при резком движении цены позиция может закрыться хуже расчетного уровня.
Где доступна опция
API Trading можно подключить на челленджах номиналом $10,000 и выше. Для счетов $1,000 и $5,000 опция недоступна.
Купить опцию можно двумя способами. Первый — выбрать ее при оформлении челленджа, тогда счет сразу создается с включенным API. Второй — докупить ее к уже активному челленджу. Для этого нужно, чтобы счет был активен, имел номинал от $10,000 и еще не перешел на фандед-этап, а опция на нем не была активирована ранее. Если какое-то условие не выполнено, платформа покажет причину.
Если опция подключена до перехода на фандед-этап, API продолжает работать и на фандед-счете. Докупить ее к челленджу, который уже перешел на фандед-этап, нельзя.
Отдельный случай — Турбо-счета, которые открываются сразу на фандед-этапе. На них опция тоже доступна, но не на всех номиналах. Актуальные варианты отображаются при оформлении счета.
API Trading доступен и на демо-счете, поэтому начинать стоит именно с него. Там можно проверить код, лимиты запросов и поведение правил, ничем не рискуя.
Как подключить API: пошагово
На демо-счете опция включается при создании челленджа. Нажмите «Попробовать на демо» и активируйте переключатель «Торговля через API». Платформа покажет предупреждение о дополнительных правилах. Подтвердите подключение и нажмите «Начать торговлю». В списке счетов появится демо-счет с отметкой о включенном API.
Для реального челленджа порядок тот же, что описан выше: опция выбирается при оформлении заказа или докупается к активному счету.
Чтобы код получил доступ к счету, нужен API-ключ. Откройте настройки аккаунта и перейдите в раздел настроек API. По умолчанию ключей там нет. Нажмите «Создать», задайте название ключа и при необходимости срок его действия, затем подтвердите создание.
Созданный ключ отображается только один раз. Скопируйте его и сразу сохраните в надежном месте, например в менеджере паролей. Это стандартная мера безопасности: если бы ключ можно было открыть повторно, любой человек с доступом к вашему устройству смог бы скопировать его и торговать от вашего имени. Если ключ потерян или скомпрометирован, создайте новый. Общие принципы защиты API-доступа описаны в рекомендациях OWASP API Security.
Первый запуск: пример из документации
Подробная API-документация Upscale описывает авторизацию, лимиты запросов, допустимые значения параметров и коды ошибок. Там же перечислены эндпоинты для торговли: данные об аккаунтах, позициях, ордерах и текущем состоянии рынков.
Начинать удобнее всего с раздела Quickstart. В нем есть два готовых примера кода, на Python и на JavaScript, и оба выполняют один и тот же сценарий:
- получают список ваших аккаунтов, чтобы определить, с каким счетом работать;
- получают список рынков и находят BTC;
- открывают маркет-ордер в лонг на $100 с плечом 5×;
- запрашивают позицию, чтобы убедиться, что она действительно открылась;
- закрывают позицию.
Чтобы запустить готовый код из Quickstart, скопируйте его в редактор, укажите свой API-ключ и выполните скрипт. Позиция откроется и закроется без единого действия в терминале. Задача этого кода — не заработать, а проверить, что связка «ключ — код — счет» работает, поэтому запускать его лучше на демо-счете.
Дальше стоит изучить раздел документации о создании ордера. В нем описаны доступные типы ордеров и назначение каждого параметра: какое плечо указывать, как задать счет и рынок, когда нужен идентификатор позиции и в каких случаях обязательна триггерная цена.
ИИ-ассистент вместо ручного кода
Писать скрипт с нуля не обязательно. Если стратегию можно описать словами, например «при отскоке от уровня поддержки ставим лимитный ордер с таким-то стопом», ее можно передать ИИ-ассистенту вместе с API-документацией Upscale и попросить написать бота. Первая рабочая версия появляется за несколько минут. Такой скрипт запускается локально: ваш компьютер выступает хостом алгоритма и отправляет запросы на сервер Upscale. Отдельный сервер для этого не нужен.
При таком подходе важно соблюдать три правила.
Не передавайте API-ключ в чат с нейросетью. Храните ключ в переменной окружения или в локальном конфигурационном файле, который код читает при запуске. Это общепринятая практика хранения секретов вне кода.
Проверяйте логику сгенерированного кода. Нейросеть может не учесть комиссии, фандинг или правила счета, и тогда реальный результат будет отличаться от расчетного. Первые версии всегда запускайте на демо-счете.
Автоматизация не исправляет стратегию. Бот исполняет ровно то, что в него заложено, только быстрее и без пауз. Если идея убыточна на дистанции, алгоритм просто быстрее приведет счет к лимиту просадки.
Типичный пример — усреднение позиции. Когда цена идет против сделки, бот докупает актив, чтобы снизить среднюю цену входа и выйти в плюс на небольшом откате. На этой логике часто строятся «торговые роботы», которые предлагают новичкам. Если рынок разворачивается, схема выглядит рабочей. Но если движение продолжается, каждое усреднение увеличивает позицию, а вместе с ней и убыток.
Возьмем Базовый счет $10,000 с лимитом дневной просадки 5% ($500) и максимальной 10% ($1,000). Бот открывает лонг на $2,000 и после каждого падения цены на 2% удваивает позицию. После четырех таких движений позиция вырастает до $16,000, а убыток — примерно $600, то есть дневной лимит уже пробит. Даже если падение растянется на несколько дней, после пятого шага позиция составит $32,000, а суммарный убыток — примерно $1,240 — превысит максимальную просадку. Убыток по открытой позиции учитывается в просадке сразу, поэтому счет закроется, не дожидаясь разворота.
Какие правила действуют на счете с опцией API
Вместе с доступом по API на счете включаются дополнительные ограничения. Платформа предупреждает о них до подключения, а после активации отключить опцию нельзя: правила действуют до конца челленджа.
Лимит частоты запросов. Если программа отправляет запросы чаще, чем допускает сервер, он возвращает ошибку, и запрос не исполняется. Это стандартный механизм защиты API, аналогичный ответу HTTP 429. Точные значения лимитов указаны в API-документации, и их стоит сразу заложить в логику бота.
60-секундная корректировка прибыли. После каждого открытия или увеличения позиции запускается 60-секундное окно. Если внутри этого окна позиция полностью или частично закрывается в плюс, эта прибыль не засчитывается. Убытки, комиссии и фандинг при этом учитываются полностью. Каждое новое увеличение позиции перезапускает окно. Например, позиция открыта в 12:00:00 и закрыта с прибылью $180 в 12:00:40. Прошло 40 секунд, поэтому засчитанный результат равен нулю. Если бы ту же позицию закрыли в 12:01:10, прибыль $180 была бы учтена полностью.
Правило 30%. Самый прибыльный день не должен давать 30% и более от общей прибыли. На этапах челленджа это условие перехода на следующую фазу, на фандед-этапе — условие доступности выплаты. Например, при прибыли по дням +$200, +$300, +$1,500, +$300 и +$200 общий результат составляет $2,500, а крупнейший день дает 60%. Чтобы его доля опустилась до 30%, общая прибыль должна вырасти до $5,000.
Оба правила применяются ко всему счету, а не только к сделкам через API. Если алгоритм перестал работать и вы решили продолжить торговлю вручную в терминале, ограничения останутся: сделки нужно удерживать дольше 60 секунд, а прибыль распределять равномерно. Подробные условия опции и механика обоих правил описаны в документации, на странице Торговля через API.
В интерфейсе это выглядит так. На карточке счета появляется иконка API и блок «Макс. профитный день» с текущим значением по правилу 30%, как на Турбо-счетах. Если к закрытию применена 60-секундная корректировка, в истории позиции результат отображается как 0 USD. При наведении курсора на десктопе или тапе на мобильном появляется пояснение с исходной суммой прибыли.
Кому опция не нужна
API Trading — инструмент для тех, кто уже понимает, зачем ему автоматизация. Опция не делает торговлю проще сама по себе и не превращает случайный скрипт в прибыльную систему.
Если вы торгуете вручную и не планируете подключать программные инструменты, покупать опцию не стоит. Доступом по API вы пользоваться не будете, а дополнительные правила на счете появятся. Если идея автоматизации вам интересна, но опыта нет, начните с демо-счета: ошибки в коде там ничего не стоят.
Ключевые выводы
API Trading открывает на Upscale программную торговлю: к челленджу номиналом от $10,000 можно подключить бота, собственный скрипт или готовый алгоритмический движок. На челленджах опция подключается до перехода на фандед-этап и продолжает работать на фандед-счете. Она также доступна на части номиналов Турбо-счетов и на демо-счете, где и стоит сначала проверять код и стратегию.
Для подключения достаточно включить опцию и создать API-ключ в настройках. Ключ показывается один раз и хранится только у трейдера. Quickstart в документации за пару минут проверяет всю связку на примере открытия и закрытия позиции. Писать код с нуля не обязательно: ИИ-ассистент соберет бота по словесному описанию стратегии, но ключ в чат передавать нельзя, а логику и учет комиссий нужно проверять самостоятельно.
Главное, что стоит учесть до покупки: вместе с опцией на весь счет, включая ручные сделки, распространяются 60-секундная корректировка прибыли и правило 30%, и отключить их нельзя. Опция полезна тем, кто торгует алгоритмически и удерживает позиции дольше минуты. Трейдерам, которые работают только вручную, она не нужна.
Начни прямо сейчас: 👉 Upscale.trade | Telegram-бот
Подписывайтесь: 📺 YouTube | 𝕏 Twitter
Коммьюнити: 💬 Telegram-чат | 🎮 Discord
Часто задаваемые вопросы
Что такое API Trading на Upscale?
Это дополнительная опция челленджа, которая открывает программный доступ к счету. С ней к счету можно подключить торгового бота, собственный скрипт или аналитические инструменты, а ордера и данные о позициях будут передаваться через запросы из кода, без интерфейса терминала.
На каких счетах доступна опция?
Опция доступна на челленджах номиналом от $10,000. Для счетов $1,000 и $5,000 она недоступна. На Турбо-счетах опция есть не на всех номиналах: актуальные варианты отображаются при оформлении счета. Подключить API можно и на демо-счете.
Можно ли подключить API к счету на фандед-этапе?
Докупить опцию к челленджу, который уже перешел на фандед-этап, нельзя. Ее можно выбрать при оформлении челленджа или добавить к активному счету до перехода. Если опция подключена раньше, API продолжает работать и на фандед-счете. Турбо-счета открываются сразу на фандед-этапе, и на части их номиналов опция доступна.
Где взять API-ключ?
Ключ создается в настройках аккаунта, в разделе настроек API. Нужно задать название и при необходимости срок действия. Ключ отображается только один раз, поэтому его нужно сразу сохранить в надежном месте. Если ключ потерян, создайте новый.
Какие правила действуют на счете с опцией API?
Действуют лимит частоты запросов, 60-секундная корректировка прибыли и правило 30%. Прибыль по сделке, закрытой в плюс менее чем через 60 секунд после открытия или увеличения позиции, не засчитывается, а убытки и комиссии учитываются полностью. Самый прибыльный день не должен давать 30% и более от общей прибыли: на этапах челленджа это условие перехода на следующую фазу, на фандед-этапе — условие выплаты.
Действуют ли эти правила на ручные сделки?
Да. Правила применяются ко всему счету независимо от того, как открыта сделка: через API или вручную в терминале. Отключить опцию после активации нельзя: правила действуют до конца челленджа.
Нужно ли уметь программировать, чтобы торговать через API?
Базовое понимание кода заметно упрощает работу, но писать скрипт с нуля не обязательно. В документации есть готовые примеры на Python и JavaScript, а ИИ-ассистент может написать бота по словесному описанию стратегии. Сгенерированный код нужно проверить на демо-счете, а API-ключ — хранить в переменной окружения и не передавать в чат.
Стоит ли покупать опцию, если я торгую вручную?
Нет. Если вы не планируете подключать программные инструменты, доступ по API использоваться не будет, а дополнительные правила на счете все равно появятся.
