bgc — ориентированный на ИИ CLI для Bitget

Управляйте единым торговым счетом Bitget (UTA v3) с помощью Claude Code, Codex CLI, OpenClaw или любого ИИ-ассистента на базе оболочки. 89 операций, 14 глаголов намерения, прогрессивное обнаружение, схемы с нулевым отклонением, детерминированная безопасность записи.
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
нажмите, чтобы скопировать
Посмотреть на GitHub
npm
Node.js ≥20
macOS
Linux
Windows
MIT License
89
Операции
7
Области
14
Глаголы намерения

Основные функции

Три возможности, которые делают bgc самым ориентированным на ИИ криптовалютным CLI на рынке.
AI Agent Native
Создано для Claude Code, Codex CLI и OpenClaw. Постепенное обнаружение позволяет любому ИИ изучать API во время выполнения — предварительная загрузка не требуется.
CLI-торговля
89 операций в 7 областях — рыночные данные, спотовая/фьючерсная торговля, управление аккаунтом, средства, субаккаунты, займы и налоговые записи. Все это прямо из вашего терминала.
Безопасность записи
Четыре детерминированных шлюза безопасности — dry-run, read-only, confirm, paper-trading. Никаких интерактивных подсказок, безопасно для автоматических ИИ-оболочек.

Прогрессивное обнаружение

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

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

Быстрый старт

Начните работу за 3 шага. Рекомендуется использовать установщик Agent Hub; ручная установка также возможна.
Установка CLI и навыка
Рекомендуется: установщик Agent Hub устанавливает bgc и развертывает навыки за один шаг. Вручную: 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
публичный
Тикеры, книга ордеров, свечи, ставка финансирования, открытый интерес
trade
order
приватный
Размещение, отмена, изменение, отмена всех
trade
позиция
приватно
Информация о позиции, история, ранг ADL, закрытие
trade
strategy_order
приватный
Стратегические/триггерные/плановые ордера
account
account_overview
приватно
Снапшот аккаунта за один вызов
аккаунт
account_config
приватно
Настройки аккаунта и информация о ключе API
account
погашение
приватный
Погашение кросс-маржи / изолированной маржи
средства
transfer_funds
приватный
Перемещение средств между счетами
funds
deposit
приватный
Адрес депозита и записи
funds
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.

Интеграция ИИ

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

Сравнение bgc и Direct API

bgc — это не просто тонкая оболочка. Он добавляет уровень намерений, безопасность и ИИ-нативный дизайн, которых нет у обычных вызовов API.
Измерение
bgc
Прямой API
Глаголы намерения
14 отобранных глаголов намерения
Сырые эндпоинты
Постепенное обнаружение

Самоописываемый интерфейс

Обязательно изучите документацию
Подпись HMAC

Автоматически

Необходимо реализовать
Ограничение скорости

Встроено на стороне клиента

Необходимо реализовать
Безопасность Записи

4 детерминированных шлюза

Необходимо реализовать
Ввод-вывод Unix

JSON в stdout (код 0) + структурированная ошибка в stderr (код 1)

Необходимо реализовать
Поиск по ключевым словам

bgc discover --search

Необходимо реализовать
Обходной путь

bgc raw --operationId

Необходимо реализовать
Логический вывод ИИ

Файл навыков подскажет, когда это использовать

Необходимо реализовать
Часто задаваемые вопросы
Что такое bitget-agent-cli?
Официальный терминальный торговый ИИ-инструмент Bitget, предоставляющий CLI (bgc) для Claude Code, Codex CLI и OpenClaw. Построенный на базе API UTA v3, он предоставляет 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 областей, затем углубляется в область, чтобы увидеть доступные глаголы, затем в глагол, чтобы увидеть доступные действия, и, наконец, в действие, чтобы увидеть точные параметры — загружая только ту часть, которая нужна для задания. Тип каждого параметра, перечисление, требования к аутентификации и флаг чтения/записи можно запросить в реальном времени во время выполнения, без поддерживаемой вручную схемы, которая могла бы отклоняться от 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. Он поддерживает пакетные и последовательные операции через ИИ-ассистента на базе оболочки или прямые bash-скрипты.

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

Ключевые функции для ИИ-агентов:

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

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

  • Никакой конфигурации хост-приложения, никаких плагинов: установите и скажите вашему ИИ, чем торговать.

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

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 обучает ваш ИИ тому, когда и как его использовать.

Ресурсы для разработчиков

agent-cli
Этот репозиторий — bgc CLI
agent-mcp
Сервер MCP для десктопного ИИ
agent-skill
Руководство по ИИ-инференсу
agent-sdk
Базовый SDK для TypeScript
bitget-signal
Навык анализа рынка
agent_hub
Единый вход в экосистему + установщик

Начните торговать с ИИ-нативным CLI

89 операций, 14 глаголов намерения, 4 уровня безопасности — все это из вашего терминала.
Посмотреть на Github