---
title: "Торговля через API"
description: "Дополнительная опция API Trading: доступность, подключение и дополнительные правила, которые она включает на счёте"
icon: code
published: true
---

**API Trading** — дополнительная опция, которая открывает программную торговлю на конкретном челлендже: подключение торгового бота, собственных скриптов или аналитических инструментов.

{% hint style="warning" %}
**Опция меняет правила всего счёта.** Вместе с доступом по API на счёте начинают действовать [60-секундная корректировка прибыли](правила-челленджа-и-торговли.md#api-rules) и [правило 30%](правила-челленджа-и-торговли.md#pravilo-30). Они применяются ко всем операциям на этом счёте — и к тем, что совершены через API, и к тем, что сделаны вручную в терминале.

Отключить опцию нельзя: после активации правила действуют до конца челленджа.
{% endhint %}

## Доступность

| Параметр | Значение |
|---|---|
| Минимальный номинал счёта | $10,000 — для счетов $1,000 и $5,000 опция недоступна |
| Стоимость | на данный момент опция бесплатна |
| Фаза челленджа | подключение доступно, пока счёт не перешёл на funded-этап |
| Демо-счёт | опция активируется при создании челленджа |

Скидка на челлендж на стоимость опций не распространяется: платные опции всегда оплачиваются по полной цене.

## Когда можно подключить

{% tabs %}
{% tab title="При покупке челленджа" %}
Опция выбирается в момент оформления заказа. После оплаты челлендж сразу получает признак API-enabled, и на нём начинают действовать дополнительные правила.
{% endtab %}

{% tab title="Для активного челленджа" %}
Опцию можно подключить к уже работающему челленджу, если одновременно выполняются условия:

* челлендж активен;
* челлендж не находится на funded-этапе;
* номинал счёта — $10,000 или выше;
* опция ещё не была активирована на этом счёте.

Если хотя бы одно условие не выполнено, платформа покажет причину недоступности.
{% endtab %}
{% endtabs %}

## Что включается вместе с опцией

| Правило | Что означает |
|---|---|
| Ограничение частоты запросов | при превышении сервер возвращает ошибку и запрос не исполняется |
| 60-секундная корректировка прибыли | Положительный результат закрытия, совершённого менее чем через 60 секунд после открытия или увеличения позиции, не учитывается |
| Правило 30% | Самый прибыльный день не должен давать 30% и более общей прибыли — условие прохождения каждой фазы и доступности выплаты |

Механика обоих правил описана на странице [Правила челленджа и торговли](правила-челленджа-и-торговли.md#api-rules).

{% hint style="info" %}
Оба правила действуют на все операции счёта — ручные и программные, по любым типам ордеров. Опция называется API Trading, но её эффект не ограничивается торговлей через API.
{% endhint %}

## Как это выглядит в интерфейсе

На карточке счёта появляется иконка API среди подключённых опций и блок «Макс. профитный день», показывающий текущее значение по правилу 30% — так же, как на Турбо-счетах.

Если к закрытию или частичному закрытию была применена 60-секундная корректировка, в истории позиции засчитанный результат отображается как `0 USD`. При наведении курсора на десктопе или тапе на мобильном появляется пояснение с причиной и исходной суммой прибыли. В общий результат позиции и счёта попадает только скорректированное значение.

## Кому подходит

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

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

---

## Быстрый старт <a href="#quick-start" id="quick-start"></a>

API-ключ создаётся в терминале: «Настройки аккаунта» → «Настройки API». По API доступны только счета, на которых подключена опция API Trading. Подключить её можно на той же странице — кнопкой «Настроить счета».

Ключ предназначен только для владельца аккаунта: не публикуйте его и не передавайте другим трейдерам. Передача ключа считается нарушением правил.

Всё, что нужно для API торговли, собрано в разделе [Developers](https://docs.upscale.trade/ru/developers) — отдельной части документации для разработчиков.

| Что там есть | Зачем нужно |
|---|---|
| Быстрый старт | открытие и закрытие позиции за пять запросов, с готовыми скриптами на JavaScript и Python |
| Аутентификация | как получить API-ключ и передавать его в запросах |
| Соглашения | формат чисел, единицы измерения полей и работа с повторными запросами |
| Лимиты запросов | ограничение частоты обращений к API |
| Ошибки | коды ответов и что они означают |
| Операции | справочник запросов по разделам «Аккаунты», «Конфигурация» и «Торговля» |

Каждый запрос в справочнике можно выполнить прямо со страницы: в блоке API Playground подставляются ключ и параметры, а по кнопке отправки приходит настоящий ответ платформы. Там же лежит готовый код запроса для cURL, JavaScript и Python.

{% hint style="warning" %}
Запросы из справочника выполняются на реальном счёте: отправленный ордер действительно создаётся. Пробуйте на демо-счёте.
{% endhint %}