> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/ai-agents.md).

# ИИ-агенты

Подключи Claude Desktop, Claude Code, Codex, Cursor или другое MCP-приложение к своему goodcryptoX с ключами для чтения, предложений и торговли в твоих лимитах.

В goodcryptoX встроены MCP-сервер и API: Claude Desktop, Claude Code, Codex, Cursor и другие MCP-приложения могут читать позиции, предлагать ордера и торговать на подключенных биржах в заданных лимитах на твоей установке, без аккаунта goodcryptoX. Программа использует [API](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/api.md). Это частная установка на твоем компьютере, NAS или сервере; MCP-сервер и API подключаются именно к ней. Публичного торгового API или MCP-сервера для подключения у нас нет.

Наш ретранслятор — стандартный способ подключения к твоей установке с другого устройства. Он не может прочитать ключ доступа, запросы или ответы. Компьютер может вместо этого использовать [SSH-туннель](#use-an-ssh-tunnel-instead), минуя ретранслятор; [телефон](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/phone-access.md) тоже может подключаться через ретранслятор.

Демо-аккаунты и режим Bybit для разработчиков, включая отправку с ключом только для чтения и восстановление, доступны людям, вошедшим в панель. Ключи доступа и MCP не могут использовать `demoBybitView` или `demo=1`.

## Что может агент <a href="#what-an-agent-can-do" id="what-an-agent-can-do"></a>

Эти действия доступны через MCP и API. Ключ задает разрешения goodcryptoX; собственные правила ИИ-агента могут разрешать меньше. Платеж из твоего кошелька, например покупка кредитов, остается за тобой: агент может подсказать, как его сделать.

С любым ключом агент может:

* **Аккаунты и активы**: читать аккаунты, балансы, позиции, открытые ордера и ботов, а также состояние аккаунта и goodcryptoX. Инструмент `portfolio` определяет известные монеты в разных аккаунтах и активы бирж без соответствия, с собственной ценой каждого актива и недостающими ценами ([API](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/api.md#portfolio-identities)).
* **Настройки залога**: читать настройки залога каждого аккаунта в снимке `balances` (`perCoinCollateral`). В нём указаны кошелёк, принимает ли биржа каждую монету и используется ли она как залог; отсутствие значения не означает, что настройка выключена. Менять настройки залога в goodcryptoX может только человек; API-ключи и инструменты MCP могут их читать. Демо-аккаунты и их настройки доступны только в сессии человека.
* **Объем торговли**: читать объем твоей торговли с момента подключения каждого аккаунта, исполненные сделки, комиссии и реализованный PnL по аккаунту и тому, кто разместил ордер, за всё время или по дням UTC. Ответ показывает, где не хватает истории или цен ([API](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/api.md#trading-volume)).
* **Ордера и история**: читать детали ордеров и завершенные ордера, а также спросить у биржи про один ордер прямо сейчас, как это делает «Обновить» на карточке ордера (на бирже ничего не меняется).
* **Детали бота**: читать планы, ордера, результаты и платежи фандинга.
* **Платежи фандинга**: читать, сколько аккаунт заплатил или получил на рынке, в какой монете прошёл платёж и какова доля каждого бота.
* **Рынки**: читать доступные рынки, торговые правила, цены и объемы свечей.
* **Базовая валюта**: читать валюту, выбранную для goodcryptoX, и ее курс к доллару.
* **Кредиты**: читать твои кредиты, оставшийся стартовый объем на CEX (`remaining`; добавь объем, который `balance` покупает по ставке `rate`, чтобы получить общий остаток объема на CEX в панели), комиссию, какие биржи платят кредитами, заканчиваются ли они или новые ордера и боты на паузе и как добавить еще. В Solana кредиты можно оплатить и в $GOOD, имеющихся или купленных любой монетой в том же платеже, со скидкой $GOOD; программа может запросить котировку платежа через `POST /api/v1/credits/pay` (`input` — сумма в монете, или `amount`, с `build: false`); сам платеж остается за тобой, из твоего кошелька. Тот же инструмент `credits` возвращает `totals`: оплаченные USD, кредиты от платежей, начисления, объем CEX и комиссии за все время; средние дневные и месячные за 30 дней объемы и комиссии; период, признак оценочной стоимости платежей и разницу баланса. Чтение по дням с `before` остается доступным.
* **Реферальный код**: читать код, с которым ты присоединился, и свою комиссию, свои три кода, сколько они заработали, сколько друзей присоединились и сколько из них разместили ордер, и твою выплату.
* **Свой ключ**: читать его уровень, аккаунты, рынки и лимиты и сколько из 24 часов он уже использовал.
* **API-ключи биржи**: повторно проверить API-ключ аккаунта Binance после изменения его разрешений на Binance и прочитать, что он теперь может.
* **Предпросмотр и отчеты**: проверять ордера и ботов без торговли, разбирать произошедшее.

С ключом **Торговля** также может:

* **Ордера**: размещать ордера с тейк-профитом и стоп-лоссом, менять свои ордера и отменять ордера вне ботов на разрешенных аккаунтах.
* **Плечо**: задавать плечо и режим маржи.
* **Поддержание API-ключа активным**: видит, включено ли Поддерживать активность моего API-ключа для аккаунта Binance; включать и выключать можешь только ты.
* **Платить комиссии в BNB**: видит, платит ли аккаунт Binance комиссии в BNB; включать и выключать можешь только ты.
* **Изолированная маржа**: добавлять маржу к изолированной позиции или снимать ее.
* **Боты**: создавать и запускать ботов; менять, останавливать или закрывать созданных им ботов.
* **Массовые действия**: отменять ордера вне ботов, останавливать своих ботов или закрывать позиции по фильтру, включая твои. Позиции ботов остаются, если он не останавливает также своих ботов с закрытием позиций.

Торговля подчиняется твоим [аккаунтам, рынкам и лимитам](#keys-and-limits); отмена охватывает ордера вне ботов на разрешенных аккаунтах независимо от рынка. Ты приостанавливаешь и возобновляешь ботов ключа через **Приостановить** и **Возобновить** в goodcryptoX; напрямую агент этого не может.

Ключ **Предложения** или **Торговля** может готовить ордера и ботов для твоей проверки и запуска в goodcryptoX. [Предложения](#proposals) не торгуют до твоего запуска. Свое ожидающее предложение агент может отозвать.

Ни один ключ не выводит и не переводит средства, не меняет настройки и не создает новые ключи. Торговый ключ меняет только свои ордера и ботов, но отменяет любые ордера вне ботов на разрешенных аккаунтах. Прямо отменять ордера ботов он не может, даже после остановки бота.

**Предложение ордера**, **Предложение бота** и момент **Лимит исчерпан** приходят в Telegram с именем ключа. **Ордер принят**, **Отмена принята** и **Бот создан** тоже приходят, если не выключить **Уведомлять меня в Telegram** в деталях ключа; изначально включено. Твои действия в панели сообщений не отправляют. Действия ключа хранятся в **Настройки › MCP & API** в разделе **Что сделал**: выставленные и отмененные ордера, установленное плечо, добавленная или снятая маржа.

## Подключение MCP-приложения или программы <a href="#connect-any-mcp-app-or-program" id="connect-any-mcp-app-or-program"></a>

Открой **Настройки › MCP & API**. Нажми **Создать ключ**, задай имя и выбери разрешения:

* **Чтение** читает ордера, позиции и ботов. Ничего не меняет.
* **Предложения** читает и предлагает ордера и ботов для запуска в панели. Без тебя торговли нет.
* **Торговля** читает, размещает и отменяет ордера, запускает своих ботов в рамках твоих [аккаунтов, рынков и лимитов](#keys-and-limits).

Снова нажми **Создать ключ**, затем **Копир.** и **Готово**. Позже открой строку ключа: **Ключ** показывает скрытый ключ с **Показать** и **Копировать**. Дай каждому приложению или программе отдельный ключ, чтобы отзывать независимо.

Под ключами блок подключения разделен на **ИИ-агенты** и **API**, а справа вверху выбран ключ, который он подставляет: последний созданный уже выбран; другой можно выбрать из списка. У каждого приложения есть строка, указывающая, куда вставить настройку: скопируй и вставь ее туда. Ключ, адрес твоей установки и способ подключения с другого компьютера уже внутри, заполнять ничего не нужно. Скопированная через наш ретранслятор строка работает и на компьютере с goodcryptoX, и на любом другом ([С другого компьютера](#from-another-computer)). Строки рассчитаны на систему браузера, в котором ты их копируешь: копируй на компьютере, где работает приложение.

Claude Code, Codex и Cursor запускают коннектор через Node.js 18 или новее на своем компьютере; Claude Desktop имеет собственный. Если приложение не находит `npx`, установи Node.js для своей системы с [nodejs.org](https://nodejs.org/) и перезапусти приложение. Первый запуск скачивает коннектор и может занять несколько секунд.

### Подключение Claude Desktop <a href="#claude-desktop" id="claude-desktop"></a>

На Mac и Windows.

1. Нажми **Скачать** рядом с **Claude Desktop** и открой файл с именем ключа двойным нажатием. Claude Desktop откроет окно установки.
2. Нажми **Установить**. Claude Desktop показывает это для каждого коннектора вне своего каталога. Наш обращается только к goodcryptoX с выданным ключом и больше ничего на компьютере не читает.
3. Claude Desktop запросит **goodcryptoX access key** — ключ доступа. Нажми **Копировать** рядом с **Скачать** в goodcryptoX, вставь ключ и нажми **Сохранить**.
4. Включи расширение: Claude Desktop оставляет его выключенным, пока ключ не сохранен.
5. Каждый инструмент goodcryptoX начинает с **Ask**: Claude Desktop спрашивает перед использованием. В строке goodcryptoX нажми **Configure** и для инструментов без запроса замени **Ask** на **Allow**; хотя бы для чтения (с заголовком **Read …**), чтобы не подтверждать каждый просмотр.
6. Спроси: «Какие у меня открытые ордера?». Ключ задает максимум возможностей агента в goodcryptoX; разрешения Claude Desktop определяют, о чем он спрашивает.

### Подключение Claude Code <a href="#claude-code" id="claude-code"></a>

В терминале, IDE и вкладке Code.

1. Нажми **Копировать** рядом с **Claude Code**.
2. Открой терминал на компьютере Claude Code (Терминал на Mac и Linux, PowerShell на Windows; терминал IDE тоже подходит), вставь строку и нажми Return. Claude Code ответит `Added stdio MCP server gcx … to user config`. Одного раза достаточно: терминал, IDE и вкладка Code используют общую настройку. Для замены ключа или строки сначала выполни `claude mcp remove <name>` с именем после `--scope user` в строке: Claude Code не принимает вторую запись с тем же именем.
3. Выполни `claude mcp list`: запись goodcryptoX показывает `✓ Connected`. В сессии Claude Code команда `/mcp` выводит его с инструментами.
4. Спроси об ордерах. Claude Code спрашивает перед первым использованием инструмента: ответь **Да** или **Yes, and don't ask again** для этого инструмента; `/permissions` показывает и меняет разрешения без запроса.

### Подключение Codex <a href="#codex" id="codex"></a>

1. Нажми **Копировать** рядом с **Codex**.
2. Проще всего вставить строки в Codex и попросить добавить их в конфигурацию. Codex сделает это и предложит перезапуск; запусти его заново.
3. Или добавь сам: открой конфигурацию Codex в текстовом редакторе, создай файл, если его нет: `~/.codex/config.toml` на Mac и Linux, `%USERPROFILE%\.codex\config.toml` на Windows. Папка `.codex` скрыта: в диалоге **Открыть** редактора на Mac нажми Cmd+Shift+G и введи `~/.codex`; на Windows введи путь выше в поле имени файла. Вставь строки в конец, сохранив имеющееся, и сохрани файл. Перезапусти Codex: новая команда `codex` в терминале или закрой и открой приложение Codex.
4. `codex mcp list` показывает goodcryptoX как `enabled`; в сессии `/mcp` выводит инструменты.
5. Спроси об ордерах. Запрос подтверждения перед инструментом зависит от настройки одобрений Codex (`/approvals` в сессии).

### Cursor и другие приложения <a href="#cursor-and-other-apps" id="cursor-and-other-apps"></a>

1. Нажми **Копировать** рядом с **Cursor и другие приложения**.
2. Проще всего вставить строки в чат Cursor и попросить добавить в настройки MCP.
3. Или добавь сам: в Cursor открой **Cursor Settings** (Cmd+Shift+J на Mac, Ctrl+Shift+J на Windows и Linux), затем **Tools & MCPs** и **Add Custom MCP**: откроется `mcp.json`. Если файл пуст, вставь строки; если серверы уже есть, вставь только запись goodcryptoX внутрь `"mcpServers"`. Сохрани.
4. Вернись в **Tools & MCPs**: goodcryptoX виден с инструментами и переключателем включения.
5. Спроси агента об ордерах. Cursor спрашивает перед запуском инструмента, если в настройках не разрешен самостоятельный запуск.

Другие приложения, запускающие MCP-серверы через стандартный ввод и вывод, принимают ту же запись: команду, аргументы и окружение. Коннектор — не веб-адрес для облачного чата.

## С другого компьютера <a href="#from-another-computer" id="from-another-computer"></a>

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

При первом запуске коннектор подключает компьютер к установке одноразовым кодом из строки. Код действует до использования, не дольше суток, независимо от открытой страницы goodcryptoX; перезапуск goodcryptoX тоже завершает действие. Затем все приложения этого компьютера подключаются сами. Компьютер появляется в **Настройки › Устройства** как **Программы на …**, с **Удалить**.

Если приложение пишет **This connector has expired. Download it again from goodcryptoX**, это не всегда значит, что прошли сутки: перезапуск goodcryptoX или использование кода на другом компьютере тоже делает старую строку непригодной. Скопируй новую строку из **Настройки › MCP & API** и замени запись в приложении по его шагам выше (в Claude Code сначала удали старую через `claude mcp remove`); для Claude Desktop снова скачай файл. Если сохраненное подключение не открывается, выполни шаги ниже.

Коннектор использует адрес твоей установки, когда может подтвердить, что по нему отвечает твой goodcryptoX. Иначе он подключается через наш ретранслятор. На другом компьютере подключение через ретранслятор — это нормально.

Если приложение пишет **Can't open or save the connection on this computer**, сначала проверь, что ты вошел под тем пользователем компьютера, который первым подключил его. Сообщение также может означать, что файл поврежден, доступ запрещен или Windows не может открыть или сохранить его. Одного копирования новой строки недостаточно, чтобы исправить сохраненные файлы.

Если сохраненные файлы нужно заменить, выполни эти шаги. Они заменят сохраненные подключения текущего пользователя компьютера; они не исправят блокировку PowerShell или права доступа к папке.

1. Закрой приложения с ИИ, которые используют goodcryptoX, и останови все запущенные `gcx connect`.
2. Открой папку с файлами: в Windows введи `%LOCALAPPDATA%\goodcryptoX` в адресной строке Проводника; на Mac используй **Переход к папке** в Finder с `~/Library/Application Support/goodcryptoX`; в Linux открой `~/.local/share/goodcryptoX` в файловом менеджере.
3. Переименуй `connect` в неиспользуемое имя, например `connect-old`. Если переименовать не получается, сначала исправь доступ к папке.
4. Скопируй новую строку из **Настройки › MCP & API**, замени запись одного приложения по его шагам выше и запусти это приложение. Для Claude Desktop снова скачай файл.
5. Повтори для каждой установки goodcryptoX, которую используешь. Затем другие приложения того же пользователя компьютера и той же установки будут использовать это сохраненное подключение.

Если приложение пишет **The connection took too long. Try again in a minute**, попробуй снова через минуту. Запущенный коннектор повторяет попытку сам; если приложение с ИИ остановило коннектор, перезапусти приложение. Если это повторяется, нужно разобраться подробнее.

Храни скопированные строки в секрете: в них ключ и, на сутки, код подключения компьютера. Файл Claude Desktop содержит код, но не ключ: его запросит Claude Desktop. Сам код ничего не читает и не торгует — нужен ключ доступа.

Работающий коннектор переподключается после сна или разрыва сети; установка торгует, пока работает и подключена к бирже. Для доступа без ретранслятора используй [SSH-туннель](#use-an-ssh-tunnel-instead).

С [домашнего адреса](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-your-mac.md#your-home-network) скопированная строка подключает ИИ-приложение или программу напрямую к установке, которая ее создала, с выбранным ключом и без нашего ретранслятора. Используй ее в сети, которой доверяешь, или через свой доверенный HTTPS-адрес: по HTTP тот, кто может читать трафик, может скопировать ключ.

## Вместо этого — SSH-туннель <a href="#use-an-ssh-tunnel-instead" id="use-an-ssh-tunnel-instead"></a>

Вместо ретранслятора можно использовать SSH-туннель; если не знаешь, что это, он тебе не нужен. Это прямое соединение твоего компьютера с компьютером goodcryptoX.

<details>

<summary>Подключение через SSH</summary>

1. На компьютере открой Терминал (PowerShell в Windows) и перенаправь локальный порт на порт goodcryptoX другого компьютера. Например, для порта 8128:

   ```sh
   ssh -N -L 8128:127.0.0.1:8128 <user>@<server-address>
   ```

   Подставь пользователя и адрес SSH, при необходимости добавь `-i <private-key-file>`. Используй фактический порт goodcryptoX с обеих сторон строки и в адресе ниже. Оставь команду работающей.
2. Открой `http://127.0.0.1:8128/gcx` через туннель с портом goodcryptoX. Для входа выполни `gcx open --print` на установке (`docker exec gcx gcx open --print` в Docker) и открой ссылку в течение 60 секунд. Подробности — в инструкции для [сервера](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in) или [NAS](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-nas.md#sign-in).
3. В **Настройки › MCP & API** скопируй строку приложения, как выше. Пока туннель работает, коннектор находит goodcryptoX по локальному адресу и общается напрямую.

Программы используют тот же локальный адрес и свой ключ. Закрытие команды SSH прекращает доступ с этого компьютера; боты и ордера продолжают работу на установке.

</details>

## Устройства и удаление <a href="#devices-and-removal" id="devices-and-removal"></a>

**Настройки › Устройства** показывают подключенные браузеры и компьютеры. Строка **Программы на …** охватывает приложения и программы одной учетной записи компьютера; ее можно переименовать или нажать **Удалить**. Подключения браузеров имеют отдельные строки.

**Удалить** завершает подключения программ компьютера, но не их ключи доступа. Подключи повторно для восстановления. Другие компьютеры остаются подключенными. Отправленные ордера могут исполниться; удаление не отменяет ордера, не останавливает ботов и не закрывает позиции. Отзови ключ отдельно, чтобы убрать доступ везде.

## Статистика ключа <a href="#key-statistics" id="key-statistics"></a>

Каждый ключ показывает свою активность в настройках и на Дашборде. **Активные** считает его открытые ордера и работающих ботов. **Объем** — стоимость сделок его ордеров и ботов, а не баланс аккаунта.

**Реализ. PnL** — реализованная прибыль или убыток от сделок этого ключа и фандинга его ботов, после комиссий. Меняющийся нереализованный PnL еще открытых позиций исключен. Например, 20 закрытой торговой прибыли минус 2 комиссии и 1 уплаченного фандинга добавляют 17. Полученный фандинг, наоборот, прибавляется к результату.

Показатели дают итог и последние 24 часа. Если ключ торгует в нескольких валютах, результаты остаются отдельными; прибыль в одной валюте не прибавляется незаметно к прибыли в другой.

## Ключи и лимиты <a href="#keys-and-limits" id="keys-and-limits"></a>

Строка ключа в **Настройки › MCP & API** показывает открытые ордера и ботов, оборот и PnL. Открой ее для лимитов и нажми **Изменить**, чтобы изменить разрешения или лимиты. Предложения ждут во вкладке **Предложения** страницы Торговля ([Предложения](#proposals)).

Для ключа **Торговля** выбери **Аккаунты** и **Рынки** (**Все**, **Спот**, **Перпы** или **Свои**: поиск с отметкой рынков в результатах), затем нужные лимиты. **Все**, **Спот** и **Перпы** включают и будущие рынки. Аккаунты и рынки ограничивают торговлю; чтение и предложения не ограничены. Без выбранных аккаунтов или рынков торговли нет.

Все денежные лимиты изначально выключены и показывают **Без лимита**: включи нужные и введи значения. Лимиты заданы в базовой валюте (**Настройки › Общие › Базовая валюта**, доллар США, пока не выберешь другую): ключ хранит валюту, в которой заданы его лимиты. Рынок с котировкой в стейблкоине считается один к одному с долларом; рынок с котировкой в монете вроде BTC оценивается по ее цене. Лимит ограничивает размер сделок агента, их стоимость, а не используемую маржу: при 5x ордер на 1,000 USD использует около 200 USD маржи.

Выбор другой базовой валюты однократно пересчитывает лимиты каждого ключа по курсу этого дня, и они остаются суммами в новой валюте: лимит 1,000 USD становится 900 EUR при курсе 0.9, и далее действует лимит 900 EUR независимо от курса. Лимиты за 24 часа суммируют ордера и ботов ключа на рынках с разными валютами котировки, оценивая каждый в валюте лимитов при проверке ордера; смена валюты не переписывает последние 24 часа. Бот с размером около лимита может быть задержан из-за изменения курса; **Повторить** запускает его, когда он снова укладывается. При превышении отказ называет обе суммы в валюте лимитов («Стоимость ордера 945.00 EUR превышает лимит этого ключа 900.00 EUR»). Если базовая валюта — BTC или ETH, лимиты задаются в монетах, а допустимая сумма в долларах меняется с их ценой.

| Раздел     | Лимит                     | Что разрешено                                                                                                                                                             |
| ---------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ордера** | **Макс. на ордер**        | Стоимость одного ордера агента, включая после изменения. Выходы из своих сделок не учитываются.                                                                           |
|            | **Макс. объём за 24 ч**   | Ордера за последние 24 часа, исполненные или открытые. Выходы из своих сделок и ордера ботов не учитываются.                                                              |
| **Боты**   | **Может запускать ботов** | Включено по умолчанию: все типы ботов или только отмеченные. Выключено: только ордера.                                                                                    |
|            | **Макс. на бота**         | Деньги одного бота: вход и все усреднения DCA, общие инвестиции Грида.                                                                                                    |
|            | **Макс. объём за 24 ч**   | Деньги ботов, запущенных за последние 24 часа. Цикл DCA считается при старте; Грид — при запуске и росте инвестиций.                                                      |
| **Перпы**  | **Макс. на позицию**      | Стоимость позиции агента на одном рынке после ордера. Видно, если рынки включают перпетуалы.                                                                              |
|            | **Макс. на все позиции**  | Стоимость всех позиций агента после ордера.                                                                                                                               |
|            | **Маржа**                 | **Только изолированная** по умолчанию или **Любая**. Изолированный режим ограничивает убыток позиции ее маржой; кросс может потерять весь аккаунт.                        |
|            | **Макс. плечо**           | Изначально 5x: максимум плеча для установки или использования. У ботов проверяется при запуске и изменении ключом. Видно вместе с маржой, если рынки включают перпетуалы. |

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

Ключ Торговля может размещать ордера и запускать ботов на разрешенных тобой аккаунтах и рынках в рамках своих лимитов. Bybit поддерживает спот, фьючерсы USDT и USDC и инверсные фьючерсы; Bybit EU — только спот. На Binance и Bybit ключ может менять плечо фьючерсов в рамках **Макс. плечо** и режим маржи в рамках **Маржа**, где биржа это позволяет. Режим маржи Bybit Unified Trading Account меняй на Bybit. Сделки на Binance, Bybit и Bybit EU оплачивают комиссию goodcryptoX [кредитами](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/supported-exchanges/trading-credits.md); новым ордерам и ботам нужны кредиты, как и твоим. На рынках с маржой в монете API и инструменты MCP возвращают размеры в контрактах, рядом со стоимостью контракта; панель показывает те же размеры в USD и в монете.

У агента в этом примере лимит ордеров за 24 часа — 10 000 USD, использовано 9 800 USD. Еще 400 дадут 10 200, поэтому goodcryptoX отклонит ордер. Выбери лимиты под свою торговлю, скопируй ключ и [подключи агента или программу](#connect-any-mcp-app-or-program).

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

* **Приостановить** запрещает ключу торговать и отменяет его ордера на бирже, открывающие или увеличивающие позицию. Боты на паузе: входы, усреднения или открытия Грида отменены, новые циклы не начинаются. Текущие выходы и позиции остаются, тейк-профиты и стоп-лоссы работают. Ключ может читать.
* **Возобновить** возвращает торговлю и продолжает ботов, восстанавливая отмененные паузой открытия и усреднения. Отдельные отмененные ордера остаются отмененными; новый ключ и подключение не нужны. Перед возобновлением оцени рынок и бота.
* **Отозвать** навсегда отключает ключ, включая чтение, с той же паузой и отменами. Боты остаются на паузе до твоей остановки. Для нового доступа создай ключ. Отозванный ключ без действий (ордеров, ботов, предложений) удаляется; с историей остается в **Отозванные**; **Активные** показывает используемые ключи.

### Что может торговый ключ <a href="#what-a-trading-key-can-do" id="what-a-trading-key-can-do"></a>

Размещает рыночные, лимитные, стоп- и трейлинг-ордера с тейк-профитом и стоп-лоссом на разрешенных аккаунтах и рынках. Измененный ордер должен укладываться в лимиты по новой стоимости.

Отменяет ордера вне ботов на разрешенных аккаунтах: свои, твои, других ключей и размещенные вне goodcryptoX. Для своих ботов использует разрешенные команды; оставшийся ордер остановленного бота ты отменяешь сам.

Может продавать твои монеты или торговать против позиции в лимитах. Если агент продает 0,1 ETH против твоего лонга 1 ETH на аккаунте с объединением позиций, лонг станет 0,9 ETH. Чтобы этого избежать, отдели другую торговлю на отдельный аккаунт.

### Чего лимиты не ограничивают <a href="#what-the-limits-do-not-bound" id="what-the-limits-do-not-bound"></a>

Лимиты ограничивают экспозицию, а не убыток. Они не ограничат потери позиций, набранных за несколько дней, не предотвратят неудачную сделку и не запретят ключу двигать или отменять свой стоп-лосс. Экспозиция нескольких ключей одного аккаунта складывается.

Используй отдельный субаккаунт только со средствами, которыми готов рискнуть. Это отделяет доступные агенту деньги от другой торговли, но не делает стратегию безопасной.

### Его боты <a href="#its-bots" id="its-bots"></a>

Бот ограничен своими лимитами, а не лимитами ордеров: вход, усреднения и сеточные ордера — его план. **Макс. на бота** проверяется при запуске или изменении агентом и при старте каждого цикла DCA. При превышении запуск отклоняется, бот не создается.

**Макс. объём за 24 ч** ботов учитывает деньги цикла DCA при старте, инвестиции Грида при запуске и каждом увеличении. Если агент запускает три DCA с входом 500 USD и четырьмя усреднениями по 300 USD, цикл — 1 700 USD. При лимите 5 000 USD первые два начнут, третий создастся и будет ждать; придет сообщение в Telegram. Он стартует сам через 24 часа после первого старта. Текущие тейк-профиты и стоп-лоссы работают.

Запрос создания без `leverage` или `marginMode` берет их у открытой позиции, а без нее — изолированную маржу и плечо 5x, как указано в справочнике API. Если биржа отклонит плечо или режим маржи, запрос создания будет отклонен и бот не запустится.

Ключ меняет только ботов, созданных им напрямую. Используй лист стратегии (пример в конце [Предложения](#proposals)) для подготовки и проверки полного плана перед разрешением запуска.

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

### Когда ключ достигает лимита <a href="#when-a-key-meets-a-limit" id="when-a-key-meets-a-limit"></a>

Дашборд показывает **Лимит исчерпан**, Telegram называет агента и лимит. Открой ключ в **Настройки › MCP & API**, проверь действия и расход. Уменьши запрос, подожди освобождения лимита или измени его сам: агент не может повысить. Снижение не закрывает существующую экспозицию. Чтобы сократить работающую, проверь **Ордера → Открытые**, **Позиции** и **Боты**.

### Проверка ордера перед отправкой <a href="#checking-an-order-first" id="checking-an-order-first"></a>

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

Предпросмотр бота DCA содержит для каждой стороны `liquidation.price`: цену, по которой биржа ликвидировала бы позицию по мере исполнения ордеров бота. При кросс-марже это оценка, которая предполагает, что больше ничего в аккаунте не меняется. `"0"` означает, что цены ликвидации нет (аккаунт полностью покрывает позицию); `liquidation` имеет значение `null`, если биржа не указывает цену ликвидации для позиции (портфельная маржа).

Предпросмотр бота DCA также содержит `margin`: `survive` — то, что нужно счету, чтобы бот дошел до стоп-лосса, а `toLast` — то, что нужно, чтобы он исполнил свой последний усредняющий ордер; обе цифры с комиссиями и в валюте, в которой рынок рассчитывается, как их показывает **Приблиз. маржа** формы. Размер каждого ордера округляется до шага биржи, поэтому `margin.range`, `position.range` и `stop.range` дают границы, между которыми цифра двигается вместе с ценой; цифра на странице — то, что было бы отправлено сейчас. Их нет, когда обе границы совпадают. Предпросмотр Грида пока не несет свою потребность: агент читает потребность DCA.

Предпросмотр бота Грид также содержит `maxLoss`, строку **Макс. убыток** формы грида: для «Стоп ниже» и «Стоп выше» — максимум, который грид может потерять при срабатывании стопа, с комиссиями (`loss` в деньгах, `lossPct` процент от инвестиций (стоимости ордеров), как его показывает форма; `by` говорит, что останавливает его первым: стоп, стоп-лосс, макс. просадка или ликвидация). `by: none` с `reason` значит, что максимума нет, например при следовании в обе стороны. Это оценка по текущей цене; см. [Макс. убыток на стопе](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/grid-bot/grid-setup.md#max-loss-at-a-stop).

Ордера торгового ключа проходят с предупреждениями формы; биржа всё еще может отказать. До торговли попроси агента объяснить предупреждения. Ключ предложений оставляет решение тебе.

## Предложения <a href="#proposals" id="proposals"></a>

Предложение — ордер или бот, подготовленный ключом **Предложения** или **Торговля**. Оно ждет твоего запуска или отклонения; до этого торговли нет, запустить можешь только ты.

Предложение приходит в Telegram со ссылкой **Открыть** после подключения устройства и ждет вверху Дашборда в **Требует внимания**. Чтобы действовать:

1. Нажми **Открыть** в Telegram или строке Дашборда. Откроется Торговля во вкладке **Предложения** со всеми ожидающими предложениями.
2. Форма ордера или бота заполнена предложением с отметкой автора. Меняй что хочешь.
3. Запусти кнопкой из заметки или нажми **Отклонить** (также в строке Дашборда).

Предложение запускается один раз. Запущенное принадлежит тебе: ключ не может его менять. Перевод ключа в **Чтение** отклоняет его ожидающие предложения, как и отзыв ключа.

Программа может отозвать свое ожидающее предложение инструментом `withdraw_proposal` или через [API](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/api.md#withdrawing-a-proposal). Оно сразу исчезнет из списка и **Требует внимания** без сообщения; карточка ключа отметит отзыв. Нельзя отозвать чужое или уже запущенное предложение.

<details>

<summary>Пример: лист стратегии превращается в бота DCA</summary>

Здесь ИИ-агент превращает лист стратегии — описание нужных ботов — в бота DCA goodcryptoX.

1. **Выбери способ одобрения.** Создай ключ **Предложения** для проверки и запуска каждого бота в goodcryptoX. Выбери **Торговля** для самостоятельного создания агентом в разрешенных аккаунтах, рынках и лимитах. Начни с предложений, чтобы проверить понимание листа.
2. **Подключи агента** по разделу [Подключение MCP-приложения или программы](#connect-any-mcp-app-or-program). Для goodcryptoX на другом компьютере [С другого компьютера](#from-another-computer) описывает подключение через ретранслятор; альтернатива — SSH-туннель.
3. **Дай лист и укажи выбор.** Начни с одного профиля: «Подготовь этот профиль ETH на моем торговом субаккаунте. Покажи настройки до создания». Укажи нужные профили; на одном рынке их экспозиции складываются.
4. **Сравни предпросмотр с листом.** Запроси предпросмотр бота goodcryptoX. Проверь вход, каждое усреднение, инвестиции, выходы и повторы. В режиме предложений [открой предложение](#proposals) и проверь форму перед **Запуск**. В торговом режиме сам укажи, когда создавать. Убыток на стопе в предпросмотре (`stop.loss`) включает комиссии: каждого ордера и стопа. Макс. убыток DCA-бота — `slMaxLossPct`, процент от его инвестиций. У бота, созданного до 3.2.1, вместо него может быть `slLossPct`, процент от маржи: показывай его как `slLossPct ÷` значение `leverage` строки с округлением вниз до 0,01 (20 при 10x — это 2), а для изменения отправляй `slMaxLossPct`.
5. **Проверь результат.** Открой **Боты** и детали бота. Проверь действия ключа в **Настройки › MCP & API**.

Пример профиля ETH DCA: вход и четыре усреднения по 359,35 USDC — пять ордеров на 1 796,75 USDC за цикл. Тейк-профит на 1,61% выше средней входа. Цель не гарантирует прибыль после всех расходов или исполнение по целевой цене.

| Настройка в листе                                                    | Что проверить в goodcryptoX                                                                                     |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Сигнал покупки, свечи 15 минут                                       | **Условие входа: Сигнал**; под **Начать, когда** технический рейтинг «Покупка» на 15m; включает сильную покупку |
| Лонг по сигналу                                                      | **Режим входа: Прямая**                                                                                         |
| Рыночный вход                                                        | **Тип входа: Маркет**                                                                                           |
| 359,35 USDC на ордер                                                 | **Размер входа: 359,35**, в USDC                                                                                |
| Четыре равных усреднения                                             | **Усредняющие ордера: 4**, **1-й уср. ордер: Вручную**, **Размер 1-го уср.: 359,35**, **Множ. размера уср.: 1** |
| Первый интервал 0,96%; следующий 1,1712% с множителем 1,22           | **Шаг 1-го уср.: 0,96%**, **Шаг цены уср.: 1,1712%**, **Множ. шага уср.: 1,22**                                 |
| Активировать усреднение при достижении предыдущего планового уровня. | **На бирже: По одному**, **Пассивный** выключено                                                                |
| Тейк-профит 1,61% от средней входа                                   | **Тейк-профит** включен на 1,61%, **Тип ТП: Лимит**, **Зафикс. ТП как % от цены входа** выключено               |
| Стоп на 2,197609% ниже последнего планового усреднения               | **Стоп-лосс** включен на 2,197609%; **Стоп-лосс как: От последнего уср. ордера, %**.                            |
| Один цикл                                                            | **Повтор после:** и **ТП**, и **СЛ** выключены                                                                  |

Десятичная запятая в листе означает то же число: 0,96% — это 0.96%. Сравни цены и объемы предпросмотра с листом. Здесь усреднения примерно на 0,960%, 2,120%, 3,519% и 5,200% ниже входа. Осознанно выбери плечо и маржу перед запуском.

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-4cbccfddbb1c69f7df536c890fcfea0d2d5ae3f0%2Fstrategy-sheet-form-entry.webp?alt=media" alt="Форма DCA с входом и усреднениями из листа стратегии, стрелка на инвестиции" width="300"><figcaption></figcaption></figure>

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-3b40082342a80336ec091fb0a958283ca3968d15%2Fstrategy-sheet-form-exits.webp?alt=media" alt="Выходы и список ордеров той же формы, стрелка на итог" width="300"><figcaption></figcaption></figure>

Попроси агента отметить неподдерживаемые правила. Настройки индикаторов другой платформы, расчетный предел убытка, перенос стопа в безубыток или срок от первого исполнения могут не иметь соответствия. Разницу нужно объяснить до торговли.

[Разрешения](#keys-and-limits) решают, читает агент, предлагает или торгует; он не выводит средства и не повышает лимиты. Для прямого запуска **Торговля** [лимиты ботов](#its-bots) охватывают все деньги бота: цикл 1 796,75 USDC превышает **Макс. на бота** в 1 000 USD, бот не создастся; измени профиль или лимит сам. Предложение по-прежнему можно подготовить для проверки и запуска.

</details>

## Вопросы <a href="#questions" id="questions"></a>

### Claude может торговать за меня? <a href="#can-claude-place-trades-for-me" id="can-claude-place-trades-for-me"></a>

Да, с ключом **Торговля**: читает, размещает и отменяет ордера, запускает своих ботов в твоих аккаунтах, рынках и лимитах. С **Предложения** без тебя торговли нет.

### У goodcryptoX есть MCP-сервер? <a href="#does-goodcryptox-have-an-mcp-server" id="does-goodcryptox-have-an-mcp-server"></a>

Да: MCP-сервер goodcryptoX подключает Claude Desktop, Claude Code, Codex, Cursor и другие MCP-приложения к твоей установке ключом из **Настройки › MCP & API**. Публичного MCP-сервера для подключения у нас нет.

### Ключ и торговля проходят через серверы goodcryptoX? <a href="#does-my-key-or-my-trading-go-through-goodcryptoxs-servers" id="does-my-key-or-my-trading-go-through-goodcryptoxs-servers"></a>

Только с другого устройства через ретранслятор, который не читает ключ доступа, запросы или ответы. [SSH-туннель](#use-an-ssh-tunnel-instead) обходит ретранслятор.

### Агент может выводить средства? <a href="#can-the-agent-withdraw-funds" id="can-the-agent-withdraw-funds"></a>

Нет: ни один ключ не выводит и не переводит средства, не меняет настройки и не создает ключи.

### Какие приложения подходят: Claude, Codex, Cursor, другие? <a href="#which-apps-work-claude-codex-cursor-others" id="which-apps-work-claude-codex-cursor-others"></a>

Claude Desktop, Claude Code, Codex и Cursor имеют отдельные строки в **Настройки › MCP & API**, без заполнения вручную. Другие приложения, запускающие MCP-серверы через стандартный ввод и вывод, принимают ту же запись.

### Есть API? <a href="#is-there-an-api" id="is-there-an-api"></a>

Да: твоя программа читает и торгует через API goodcryptoX с теми же ключами, разрешениями и лимитами, что у ИИ-агента ([API](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/api.md)).
