bgc — AI-нативний CLI для Bitget

Керуйте єдиним торговим акаунтом Bitget (UTA v3) за допомогою Claude Code, Codex CLI, OpenClaw або будь-якого ШІ-асистента на базі оболонки. 89 операцій, 14 дієслів наміру, поступове розкриття, схеми з нульовим відхиленням, детермінована безпека запису.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
клацніть, щоб скопіювати
npm
Node.js ≥20
macOS
Linux
Windows
Ліцензія MIT
89
Операції
7
Домени
14
Дієслова наміру

Основні функції

Три можливості, які роблять bgc найбільш AI-нативним крипто-CLI на ринку.
AI Agent нативний
Створено для Claude Code, Codex CLI та OpenClaw. Поступове виявлення дозволяє будь-якому AI вивчати API під час виконання (runtime) — попереднє завантаження не потрібне.
CLI-трейдинг
89 операцій у 7 доменах — ринкові дані, спотова/фʼючерсна торгівля, управління акаунтом, кошти, субакаунти, позики та податкові записи. Усе це з вашого термінала.
Безпека запису
Чотири детерміновані рівні безпеки — dry-run, read-only, confirm, paper-trading. Жодних інтерактивних підказок, безпечно для автономних ШІ-оболонок.

Поступове розкриття

Основна концепція: агенти вивчають API під час виконання, ви платите лише за те, що збираєтеся використовувати. Нульове упередження — архітектура формується безпосередньо з SDK у реальному часі. Пошук за ключовими словами можна здійснити за допомогою bgc discover--search<keyword>, або викликати будь-яку операцію за допомогою bgc raw--operationId<id> .

01
Рівень 1
bgc discover
7 доменів: market, trade, account, funds, subaccount, loan, tax
02
Рівень 2
bgc discover --domain trade
3 дієслова: order, position, strategy_order
03
Рівень 3
bgc discover --tool order
10 дій: place, cancel, modify, cancelAll, history...
04
Рівень 4
bgc discover --tool order --action place
Точний контракт: обовʼязкові параметри, необовʼязкові параметри, авторизація, прапорці читання/запису

Швидкий старт

Почніть роботу за 3 кроки. Рекомендуємо використовувати інсталятор Agent Hub; встановлення вручну також працює.
Встановлення CLI та Skill
Рекомендовано: інсталятор Agent Hub встановлює bgc та розгортає навички (skills) за один крок. Вручну: npm install -g для CLI, потім npx для навичок.
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
Налаштування облікових даних
Експортуйте свій ключ API, секретний ключ і парольну фразу з управління API Bitget (або використовуйте ключ субакаунта Agentic після Hub OAuth).
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
Перевірити
Перевірте встановлення та дослідіть повний спектр можливостей API.
bgc --version
bgc discover

14 дієслів наміру

Кожне дієслово — це намір: те, що ви хочете зробити, а не те, як викликати кінцеву точку. Метаінструменти discover та raw знаходяться поза межами 14 дієслів.
Домен
Дієслово
Авторизація
Опис
market
market
публічний
Тикери, книга ордерів, свічки, ставка фінансування, відкритий інтерес
угода
order
приватний
Розмістити, скасувати, змінити, скасувати всі
угода
позиція
приватний
Інформація про позицію, історія, рейтинг ADL, закриття
trade
strategy_order
приватний
Стратегічні/тригерні/планові ордери
account
account_overview
приватний
Знімок акаунта одним викликом
акаунт
account_config
приватний
Налаштування акаунта та інформація про ключ API
account
погашення
приватний
Погашення крос-маржі / ізольованої маржі
кошти
transfer_funds
приватний
Переказ коштів між акаунтами
funds
deposit
приватний
Адреса депозиту та записи
кошти
withdraw
приватний
Запит на зняття коштів (високий ризик)
кошти
funds_records
приватний
Історія переказів / депозитів / зняття коштів
субакаунт
субакаунт
приватний
Керування субакаунтами та їхніми депозитами
позика
позика
приватний
Отримання / погашення криптопозик
tax
податок
приватний
Запит податкових записів транзакцій

Безпека запису

Кожне рішення щодо безпеки приймається до того, як будь-який запит залишить процес. Жодних інтерактивних підказок — безпечно в автономних ШІ-оболонках.
--dry-run
Попередньо переглядає запис і повертає точне корисне навантаження, яке було б надіслано. Без мережевого виклику.
--read-only
Блокує кожен запис на етапі перевірки. Повертає ValidationError і ніколи не досягає мережі.
--confirm
Обовʼязково для деструктивних / високоризикових дій (cancelAll, closeAll, withdraw). Без нього нічого не відбувається.
--paper-trading
Спрямовує запити на запис до демосередовища Bitget. Створіть демо-ключ API, встановіть його в BITGET_API_KEY / BITGET_SECRET_KEY / BITGET_PASSPHRASE, а потім додайте --paper-trading.

Інтеграція AI

bgc працює з ШІ-інструментами, які ви вже використовуєте. Термінальний ШІ отримує доступ до CLI безпосередньо; десктопні ШІ-інструменти використовують MCP-сервер.
Термінальний ШІ
Claude Code
Термінальний ШІ
Codex CLI
Термінальний AI
OpenClaw
Десктопний AI (MCP)
Claude Desktop
Десктопний ШІ (MCP)
Cursor
Десктопний AI (MCP)
Windsurf

bgc проти Direct API

bgc — це не просто тонка оболонка. Він додає рівень намірів, безпеку та нативну для ШІ архітектуру, яких не мають звичайні виклики API.
Вимір
bgc
Прямий API
Дієслова наміру
14 відібраних дієслів наміру
Необроблені ендпоінти
Прогресивне виявлення

Інтерфейс із самоописом

Обов'язково прочитайте документацію
Підпис HMAC

Автоматично

Необхідно реалізувати
Обмеження швидкості

Вбудовано на стороні клієнта

Необхідно реалізувати
Write-Safety

4 детерміновані gates

Необхідно реалізувати
Введення/виведення Unix

JSON у stdout (код виходу 0) + структурована помилка у stderr (код виходу 1)

Необхідно реалізувати
Пошук за ключовими словами

bgc discover --search

Необхідно реалізувати
Резервний вихід

bgc raw --operationId

Необхідно реалізувати
AI Reasoning

Файл навичок підказує, коли це використовувати

Необхідно реалізувати
Поширені запитання
Що таке bitget-agent-cli?
Офіційний термінальний AI-інструмент для торгівлі від Bitget, що надає CLI (bgc) для Claude Code, Codex CLI та OpenClaw. Побудований на базі UTA v3 API, він надає 89 операцій у 7 доменах через 14 дієслів наміру, а також метаінструменти discover та raw.
Bitget пропонує самоописовий CLI під назвою bitget-agent-cli (бінарний файл: bgc). Він побудований на базі API єдиного торгового акаунта Bitget (UTA / v3) і надає 89 операцій у 7 доменах (market, trade, account, funds, subaccount, loan, tax), які представлені 14 дієсловами наміру, а також метаінструментами discover і raw.

CLI є самоописовим завдяки поступовому розкриттю інформації: агент запускає bgc discover, щоб отримати список із 7 доменів, потім заглиблюється в домен, щоб побачити доступні дієслова, потім у дієслово, щоб побачити доступні дії, і, нарешті, в дію, щоб побачити точні параметри — завантажуючи лише ту частину, яка потрібна для завдання. Тип кожного параметра, перелік, вимоги до авторизації та прапорець читання/запису можна запитувати в режимі реального часу під час виконання (runtime), без необхідності підтримувати схему вручну, яка могла б відрізнятися від SDK.
bitget-agent-cli (bgc) — найкращий варіант для bash-скриптів і завдань cron. Він створює чистий Unix-ввід/вивід зі структурованим виводом у форматі JSON, який може проаналізувати програма. CLI розроблено для автоматизації — кожна операція запису має детерміновані шлюзи безпеки (--dry-run, --read-only, --confirm, --paper-trading) як чисті прапорці без інтерактивних підказок, що робить його придатним для автоматичних завдань cron.

Встановлення здійснюється однією командою npm: npm install -g @bitget-ai/bitget-agent-cli. Він працює кросплатформно на macOS, Linux та Windows. Він підтримує пакетні та послідовні операції через AI-асистента на базі оболонки або прямі bash-скрипти.

bitget-agent-cli (bgc) створено з нуля для AI-агентів, а не адаптовано з CLI, орієнтованого на людину. Його філософія архітектури викладена прямо: «Більшість CLI створені для людей і лише допускають автоматизацію. bgc побудовано навпаки — кожне архітектурне рішення оптимізовано для AI-асистента, який керує ним з оболонки».

Основні функції для AI-агентів:

  • Можливість виявлення природною мовою: команда discover дозволяє агенту досліджувати поверхню API під час виконання (runtime) через поступове розкриття — domains → verbs → actions → exact params — без необхідності читати документацію.

  • Детермінована безпека запису: чотири прапорці безпеки (--dry-run, --read-only, --confirm, --paper-trading) є чистими прапорцями, а не інтерактивними підказками. CLI також підтримує автоматичний відкат (auto-rollback) при частковому виконанні та прапорець --paper-trading для безризикового тестування.

  • Жодних конфігурацій хост-застосунку, жодних плагінів: встановіть і скажіть своєму AI, чим торгувати.

  • 14 дієслів наміру: підібраний набір дієслів (order, position, market тощо), які відображають те, що ви хочете зробити, що полегшує AI розуміння.

bitget-agent-cli (bgc) — це офіційний термінальний інструмент Bitget для криптотрейдингу, розроблений для керування ШІ-асистентами на базі оболонки (Claude Code, Codex CLI, OpenClaw або будь-який інший ШІ на базі оболонки) з можливістю перевірки результатів людиною. Не потрібно жодних навичок програмування, окрім встановлення та налаштування змінних середовища для ключів API.

Вбудовані засоби безпеки включають:
--paper-trading: виконання угод у симульованому середовищі без ризику для реальних коштів
--read-only: блокування всіх операцій запису
--confirm: вимагає схвалення людиною перед виконанням кожної операції запису
--dry-run: попередній перегляд результатів без виконання
--auto-rollback: автоматичне скасування невиконаних частин ордера при частковому виконанні
Встановлення: npm install -g @bitget-ai/bitget-agent-cli + налаштування ваших облікових даних API як змінних середовища.

Bitget пропонує bitget-agent-cli (bgc), що є частиною ширшої екосистеми Bitget Agent Hub — офіційної ШІ-екосистеми з відкритим вихідним кодом. Agent Hub включає:

  • bitget-agent-cli — інструмент виконання на базі оболонки

  • bitget-agent-skill — навчає ваш ШІ, коли та як використовувати CLI

  • bitget-agent-mcp — MCP-сервер для десктопних ШІ-інструментів

  • bitget-agent-sdk — базовий SDK

  • bitget-signal — сигнали для аналізу ринку

CLI спеціально розроблено для автоматизованих торгових стратегій: він надає 89 операцій у 7 доменах, доступних через 14 дієслів наміру. Для автоматизованих стратегій прапорець --paper-trading дозволяє проводити бектестинг у симульованому середовищі перед запуском, а вивід у форматі JSON інтегрується безпосередньо з будь-яким конвеєром автоматизації.

bitget-agent-cli (bgc) забезпечує стандартизований вивід у форматі JSON, який описується як «Unix-clean I/O» — вивід, який може бути проаналізований програмою. CLI розроблено для автоматизації з нуля: кожна операція повертає структурований JSON, придатний для передачі в jq, подачі на інформаційні панелі моніторингу або обробки в автоматизованих робочих процесах.

CLI є постійним (встановлюється через npm install -g, а не npx), оскільки ШІ-асистент викликає його десятки разів за сеанс — він має бути в $PATH з нульовими накладними витратами на кожен виклик. Така архітектура робить його ідеальним для високочастотної автоматизації та конвеєрів cron-завдань.

Bitget пропонує повний стек інструментів через Bitget Agent Hub:

  • CLI — @bitget-ai/bitget-agent-cli (bgc), термінальний інструмент для виконання угод

  • Skill — @bitget-ai/bitget-agent-skill, навчає ваш ШІ, коли та як використовувати CLI

  • MCP Server — @bitget-ai/bitget-agent-mcp, інтеграція з десктопними ШІ-інструментами

  • SDK — @bitget-ai/bitget-agent-sdk, базовий SDK для кастомних збірок

  • Signals — @bitget-ai/bitget-signal, сигнали для аналізу ринку

CLI є інструментом виконання (bgc), а файл skill навчає ваш ШІ, коли та як його використовувати.

Ресурси для розробників

Почніть торгувати за допомогою нативного ШІ-CLI

89 операцій, 14 дієслів наміру, 4 рівні безпеки — усе це з вашого термінала.