> 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-uk/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-uk/goodcryptox-3.0/api.md). Це приватна інсталяція на твоєму комп'ютері, NAS чи сервері; MCP-сервер та API підключаються саме до неї. Публічного торгового API чи MCP-сервера для підключення в нас немає.

Наш ретранслятор — стандартний спосіб підключення до твоєї установки з іншого пристрою. Він не може прочитати ключ доступу, запити чи відповіді. Комп'ютер може натомість використовувати [SSH-тунель](#use-an-ssh-tunnel-instead), оминаючи ретранслятор; [телефон](https://docs.goodcrypto.app/goodcryptox-uk/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-uk/goodcryptox-3.0/api.md#portfolio-identities)).
* **Налаштування застави**: читати налаштування застави кожного акаунта у знімку `balances` (`perCoinCollateral`). Він указує гаманець, чи приймає біржа кожну монету та чи використовується вона як застава; відсутнє значення не означає, що налаштування вимкнено. Змінювати налаштування застави в goodcryptoX може лише людина; API-ключі й інструменти MCP можуть їх читати. Демо-акаунти та їхні налаштування доступні лише в сесії людини.
* **Обсяг торгівлі**: читати обсяг твоєї торгівлі відтоді, як підключено кожен акаунт, виконані угоди, комісії та реалізований PnL за акаунтом і тим, хто розмістив ордер, за весь час або за днями UTC. Відповідь показує, де бракує історії чи цін ([API](https://docs.goodcrypto.app/goodcryptox-uk/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-uk/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-uk/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in) чи [NAS](https://docs.goodcrypto.app/goodcryptox-uk/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-uk/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-uk/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-uk/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://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-4cbccfddbb1c69f7df536c890fcfea0d2d5ae3f0%2Fstrategy-sheet-form-entry.webp?alt=media" alt="Форма DCA зі входом та усередненнями з аркуша стратегії, стрілка на інвестиції" width="300"><figcaption></figcaption></figure>

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%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-uk/goodcryptox-3.0/api.md)).
