{"format":"opendoc-document","version":1,"url":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api","title":"Торговля через API","description":"Дополнительная опция API Trading: доступность, подключение, дополнительные правила и работа с AI-агентом через MCP","kind":"article","locale":"ru","inLanguage":"ru","lastModified":"2026-10-29T09:17:16Z","revision":"02f664de9e120872036faf241a4d5b8ec85493f1ddedbd0c7f2ee1cb6f859652","section":{"title":"Документация","url":"https://docs.upscale.trade/ru"},"representations":{"html":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api","markdown":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api.md","json":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api.json"},"translations":{"en":"https://docs.upscale.trade/how-upscale-works/api_trading","ru":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api","es":"https://docs.upscale.trade/es/como-funciona-upscale/api_trading_es"},"breadcrumbs":[{"title":"Что такое проп-трейдинг","url":"https://docs.upscale.trade/ru"},{"title":"Торговля через API","url":"https://docs.upscale.trade/ru/kak-rabotaet-upscale/torgovlya-cherez-api"}],"headings":[{"depth":2,"id":"dostupnost","title":"Доступность"},{"depth":2,"id":"kogda-mozhno-podklyuchit","title":"Когда можно подключить"},{"depth":2,"id":"chto-vklyuchaetsya-vmeste-s-opciei","title":"Что включается вместе с опцией"},{"depth":2,"id":"kak-eto-vyglyadit-v-interfeise","title":"Как это выглядит в интерфейсе"},{"depth":2,"id":"komu-podkhodit","title":"Кому подходит"},{"depth":2,"id":"quick-start","title":"Быстрый старт"},{"depth":2,"id":"mcp","title":"Подключение AI-агента через MCP"}],"markdown":"---\ntitle: \"Торговля через API\"\ndescription: \"Дополнительная опция API Trading: доступность, подключение, дополнительные правила и работа с AI-агентом через MCP\"\nicon: code\npublished: true\n---\n\n**API Trading** — дополнительная опция, которая открывает программную торговлю на конкретном челлендже: подключение торгового бота, собственных скриптов, аналитических инструментов или AI-агента.\n\n{% hint style=\"warning\" %}\n**Опция меняет правила всего счёта.** Вместе с доступом по API на счёте начинают действовать [60-секундная корректировка прибыли](правила-челленджа-и-торговли.md#api-rules) и [правило 30%](правила-челленджа-и-торговли.md#pravilo-30). Они применяются ко всем операциям на этом счёте — и к тем, что совершены через API, и к тем, что сделаны вручную в терминале.\n\nОтключить опцию нельзя: после активации правила действуют до конца челленджа.\n{% endhint %}\n\n## Доступность\n\n| Параметр | Значение |\n|---|---|\n| Минимальный номинал счёта | $10,000 — для счетов $1,000 и $5,000 опция недоступна |\n| Стоимость | на данный момент опция бесплатна |\n| Фаза челленджа | подключение доступно, пока счёт не перешёл на фандед-этап |\n| Демо-счёт | опция активируется при создании челленджа |\n\nСкидка на челлендж на стоимость опций не распространяется: платные опции всегда оплачиваются по полной цене.\n\n## Когда можно подключить\n\n{% tabs %}\n{% tab title=\"При покупке челленджа\" %}\nОпция выбирается в момент оформления заказа. После оплаты челлендж сразу получает признак API-enabled, и на нём начинают действовать дополнительные правила.\n{% endtab %}\n\n{% tab title=\"Для активного челленджа\" %}\nОпцию можно подключить к уже работающему челленджу, если одновременно выполняются условия:\n\n* челлендж активен;\n* челлендж не находится на фандед-этапе;\n* номинал счёта — $10,000 или выше;\n* опция ещё не была активирована на этом счёте.\n\nЕсли хотя бы одно условие не выполнено, платформа покажет причину недоступности.\n{% endtab %}\n{% endtabs %}\n\n## Что включается вместе с опцией\n\n| Правило | Что означает |\n|---|---|\n| Ограничение частоты запросов | при превышении сервер возвращает ошибку и запрос не исполняется |\n| 60-секундная корректировка прибыли | Положительный результат закрытия, совершённого менее чем через 60 секунд после открытия или увеличения позиции, не учитывается |\n| Правило 30% | Самый прибыльный день не должен давать 30% и более общей прибыли — условие прохождения каждой фазы и доступности выплаты |\n\nМеханика обоих правил описана на странице [Правила челленджа и торговли](правила-челленджа-и-торговли.md#api-rules).\n\n{% hint style=\"info\" %}\nОба правила действуют на все операции счёта — ручные и программные, по любым типам ордеров. Опция называется API Trading, но её эффект не ограничивается торговлей через API.\n{% endhint %}\n\n## Как это выглядит в интерфейсе\n\nНа карточке счёта появляется иконка API среди подключённых опций и блок «Макс. профитный день», показывающий текущее значение по правилу 30% — так же, как на Турбо-счетах.\n\nЕсли к закрытию или частичному закрытию была применена 60-секундная корректировка, в истории позиции засчитанный результат отображается как `0 USD`. При наведении курсора на десктопе или тапе на мобильном появляется пояснение с причиной и исходной суммой прибыли. В общий результат позиции и счёта попадает только скорректированное значение.\n\n## Кому подходит\n\nОпция нужна тем, кто торгует алгоритмически: подключает бота или AI-агента, автоматизирует вход и выход или собирает торговую телеметрию собственными инструментами.\n\nЕсли вы торгуете вручную и не планируете подключать программные инструменты, подключать опцию не стоит: доступ по API вы не используете, а ограничения на счёте появятся.\n\n---\n\n## Быстрый старт <a href=\"#quick-start\" id=\"quick-start\"></a>\n\nAPI-ключ создаётся в терминале: «Настройки аккаунта» → «Настройки API и MCP» → вкладка «API-ключи». По API доступны только счета, на которых подключена опция API Trading. Подключить её можно на той же странице — кнопкой «Настроить счета».\n\nКлюч предназначен только для владельца аккаунта: не публикуйте его и не передавайте другим трейдерам. Передача ключа считается нарушением правил.\n\nВсё, что нужно для API-торговли, собрано в разделе [Developers](https://docs.upscale.trade/ru/developers) — отдельной части документации для разработчиков.\n\n| Что там есть | Зачем нужно |\n|---|---|\n| Быстрый старт | открытие и закрытие позиции за пять запросов, с готовыми скриптами на JavaScript и Python |\n| Аутентификация | как получить API-ключ и передавать его в запросах |\n| Соглашения | формат чисел, единицы измерения полей и работа с повторными запросами |\n| Лимиты запросов | ограничение частоты обращений к API |\n| Ошибки | коды ответов и что они означают |\n| Операции | справочник запросов по разделам «Аккаунты», «Конфигурация» и «Торговля» |\n\nКаждый запрос в справочнике можно выполнить прямо со страницы: в блоке API Playground подставляются ключ и параметры, а по кнопке отправки приходит настоящий ответ платформы. Там же лежит готовый код запроса для cURL, JavaScript и Python.\n\n{% hint style=\"warning\" %}\nЗапросы из справочника выполняются на реальном счёте: отправленный ордер действительно создаётся. Пробуйте на демо-счёте.\n{% endhint %}\n\n---\n\n## Подключение AI-агента через MCP <a href=\"#mcp\" id=\"mcp\"></a>\n\nК счетам можно подключить AI-агента — ChatGPT, Claude, Claude Code или Cursor. Агент работает через протокол MCP: показывает данные счёта и открытые позиции, а также может выставлять ордера по вашим запросам.\n\nАгенту доступны только счета с подключённой опцией API Trading, и на них действуют все правила опции, описанные выше. Если таких счетов нет, платформа предложит подключить опцию или попробовать агента на демо-счёте.\n\n**Адрес сервера:** `https://mcp.upscale.trade`\n\n{% tabs %}\n{% tab title=\"По адресу сервера\" %}\n1. Откройте «Настройки API и MCP» → вкладка «MCP» → «Подключить» и выберите своего агента: для каждого есть пошаговая инструкция.\n2. Добавьте адрес сервера в настройках агента.\n3. Агент откроет в браузере страницу подтверждения. Нажмите «Разрешить доступ» и вернитесь к агенту.\n\nПример для Claude Code:\n\n```\nclaude mcp add --transport http upscale https://mcp.upscale.trade\n```\n{% endtab %}\n\n{% tab title=\"По API-ключу\" %}\nДобавьте адрес сервера и свой API-ключ в конфигурацию агента. Страница подтверждения в этом случае не показывается.\n\n```json\n{ \"mcpServers\": { \"upscale\": { \"url\": \"https://mcp.upscale.trade\", \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" } } } }\n```\n{% endtab %}\n{% endtabs %}\n\nПодключения по адресу сервера отображаются во вкладке «MCP» с датой подключения и последнего использования. Кнопка «Отключить» сразу закрывает агенту доступ к счетам. Подключения по API-ключу в этом списке не показываются: чтобы отключить такого агента, удалите ключ.\n\nНа один аккаунт можно создать до 10 API-ключей. Каждое подключение агента по адресу сервера тоже учитывается в этом лимите.\n\n{% hint style=\"warning\" %}\nАгент выставляет реальные ордера на ваших счетах. Проверяйте его действия, а новые сценарии сначала пробуйте на демо-счёте.\n{% endhint %}\n","text":"API Trading — дополнительная опция, которая открывает программную торговлю на конкретном челлендже: подключение торгового бота, собственных скриптов, аналитических инструментов или AI агента. Опция меняет правила всего счёта. Вместе с доступом по API на счёте начинают действовать 60 секундная корректировка прибыли и правило 30%. Они применяются ко всем операциям на этом счёте — и к тем, что совершены через API, и к тем, что сделаны вручную в терминале. Отключить опцию нельзя: после активации правила действуют до конца челленджа. Доступность Параметр Значение Минимальный номинал счёта $10,000 — для счетов $1,000 и $5,000 опция недоступна Стоимость на данный момент опция бесплатна Фаза челленджа подключение доступно, пока счёт не перешёл на фандед этап Демо счёт опция активируется при создании челленджа Скидка на челлендж на стоимость опций не распространяется: платные опции всегда оплачиваются по полной цене. Когда можно подключить Опция выбирается в момент оформления заказа. После оплаты челлендж сразу получает признак API enabled, и на нём начинают действовать дополнительные правила. Опцию можно подключить к уже работающему челленджу, если одновременно выполняются условия: челлендж активен; челлендж не находится на фандед этапе; номинал счёта — $10,000 или выше; опция ещё не была активирована на этом счёте. Если хотя бы одно условие не выполнено, платформа покажет причину недоступности. Что включается вместе с опцией Правило Что означает Ограничение частоты запросов при превышении сервер возвращает ошибку и запрос не исполняется 60 секундная корректировка прибыли Положительный результат закрытия, совершённого менее чем через 60 секунд после открытия или увеличения позиции, не учитывается Правило 30% Самый прибыльный день не должен давать 30% и более общей прибыли — условие прохождения каждой фазы и доступности выплаты Механика обоих правил описана на странице Правила челленджа и торговли. Оба правила действуют на все операции счёта — ручные и программные, по любым типам ордеров. Опция называется API Trading, но её эффект не ограничивается торговлей через API. Как это выглядит в интерфейсе На карточке счёта появляется иконка API среди подключённых опций и блок «Макс. профитный день», показывающий текущее значение по правилу 30% — так же, как на Турбо счетах. Если к закрытию или частичному закрытию была применена 60 секундная корректировка, в истории позиции засчитанный результат отображается как 0 USD . При наведении курсора на десктопе или тапе на мобильном появляется пояснение с причиной и исходной суммой прибыли. В общий результат позиции и счёта попадает только скорректированное значение. Кому подходит Опция нужна тем, кто торгует алгоритмически: подключает бота или AI агента, автоматизирует вход и выход или собирает торговую телеметрию собственными инструментами. Если вы торгуете вручную и не планируете подключать программные инструменты, подключать опцию не стоит: доступ по API вы не используете, а ограничения на счёте появятся. Быстрый старт открытие и закрытие позиции за пять запросов, с готовыми скриптами на JavaScript и Python Аутентификация как получить API ключ и передавать его в запросах Соглашения формат чисел, единицы измерения полей и работа с повторными запросами Лимиты запросов ограничение частоты обращений к API Ошибки коды ответов и что они означают Операции справочник запросов по разделам «Аккаунты», «Конфигурация» и «Торговля» Каждый запрос в справочнике можно выполнить прямо со страницы: в блоке API Playground подставляются ключ и параметры, а по кнопке отправки приходит настоящий ответ платформы. Там же лежит готовый код запроса для cURL, JavaScript и Python. Запросы из справочника выполняются на реальном счёте: отправленный ордер действительно создаётся. Пробуйте на демо счёте. Подключение AI агента через MCP К счетам можно подключить AI агента — ChatGPT, Claude, Claude Code или Cursor. Агент работает через протокол MCP: показывает данные счёта и открытые позиции, а также может выставлять ордера по вашим запросам. Агенту доступны только счета с подключённой опцией API Trading, и на них действуют все правила опции, описанные выше. Если таких счетов нет, платформа предложит подключить опцию или попробовать агента на демо счёте. Адрес сервера: https://mcp.upscale.trade 1. Откройте «Настройки API и MCP» → вкладка «MCP» → «Подключить» и выберите своего агента: для каждого есть пошаговая инструкция. 2. Добавьте адрес сервера в настройках агента. 3. Агент откроет в браузере страницу подтверждения. Нажмите «Разрешить доступ» и вернитесь к агенту. Пример для Claude Code: Добавьте адрес сервера и свой API ключ в конфигурацию агента. Страница подтверждения в этом случае не показывается. Подключения по адресу сервера отображаются во вкладке «MCP» с датой подключения и последнего использования. Кнопка «Отключить» сразу закрывает агенту доступ к счетам. Подключения по API ключу в этом списке не показываются: чтобы отключить такого агента, удалите ключ. На один аккаунт можно создать до 10 API ключей. Каждое подключение агента по адресу сервера тоже учитывается в этом лимите. Агент выставляет реальные ордера на ваших счетах. Проверяйте его действия, а новые сценарии сначала пробуйте на демо счёте."}