bgc — Bitget向けのAIネイティブCLI

Claude Code、Codex CLI、OpenClaw、またはその他のシェルベースAIアシスタントから、Bitget Unified Trading Account(UTA v3)を操作できます。89の操作、14の意図動詞、段階的な探索、乖離ゼロのスキーマ、決定論的な書き込み安全性。
$
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
クリックしてコピー
npm
Node.js ≥20
macOS
Linux
Windows
MIT License
89
操作
7
ドメイン
14
意図動詞

コア機能

bgcを市場で最もAIネイティブな暗号資産CLIにする3つの機能。
AI Agent 原生
Claude Code、Codex CLI、およびOpenClaw向けに構築されています。段階的な発見メカニズムにより、あらゆるAIが実行時にAPIを学習できます。事前の読み込みは必要ありません。
CLI取引
マーケットデータ、現物/先物取引、アカウント管理、資金、サブアカウント、ローン、税務記録など、7つのドメインにわたる89の操作。すべてターミナルから実行できます。
書き込み安全性
4つの決定論的な安全ゲート — dry-run、read-only、confirm、paper-trading。対話型プロンプトは不要で、無人運用のAIシェルでも安全です。

段階的な探索

中核となる理念:エージェントは実行時に 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のインストールとスキルの導入を1ステップで実行できます。手動:CLIをnpm install -gでインストールし、スキルをnpxで実行します。
npx @bitget-ai/bitget-agent-installer upgrade-all --target all
認証情報を設定
BitgetのAPI管理からAPIキー、シークレット、パスフレーズをエクスポートします(または、Hub OAuth後にエージェント用のサブアカウントキーを使用します)。
export BITGET_API_KEY="..."
export BITGET_SECRET_KEY="..."
export BITGET_PASSPHRASE="..."
検証
インストールを確認し、APIの全機能を探索しましょう。
bgc --version
bgc discover

14の意図動詞

すべての動詞は意図(エンドポイントの呼び出し方ではなく、実行したいこと)を表します。メタツールの discover と raw は14の動詞には含まれません。
ドメイン
動詞
認証
説明
market
market
公開
ティッカー、オーダーブック、ローソク足、資金調達率、OI
trade
order
私有
発注、キャンセル、変更、全件キャンセル
trade
ポジション
プライベート
ポジション情報、履歴、自動デレバレッジ(ADL)ランク、決済
trade
strategy_order
私有
Bot/トリガー/計画注文
account
account_overview
プライベート
1回の呼び出しでアカウントのスナップショットを取得
アカウント
account_config
プライベート
アカウント設定とAPIキー情報
account
返済
私有
クロスマージン / 分離マージンの払い戻し
funds
transfer_funds
私有
アカウント間で資金を振替
funds
deposit
私有
入金アドレスと記録
funds
withdraw
プライベート
出金リクエスト(高リスク)
資金
funds_records
私有
振替/預金/出金履歴
サブアカウント
サブアカウント
プライベート
サブアカウントとその預金を管理
ローン
ローン
私有
暗号資産ローンを借りる/返済する
tax
税金
プライベート
トランザクションの税務記録を照会

書き込み安全性

すべての安全判断は、リクエストがプロセスを離れる前に完了します。対話型プロンプトは不要で、無人運用のAIシェルでも安全です。
--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は、すでに使用しているAIツールと連携します。ターミナルAIはCLIを直接利用でき、デスクトップAIツールはMCPサーバーを利用します。
ターミナルAI
Claude Code
ターミナルAI
Codex CLI
ターミナルAI
OpenClaw
デスクトップAI(MCP)
Claude Desktop
デスクトップAI(MCP)
Cursor
デスクトップAI(MCP)
Windsurf

bgc vs Direct API

bgcは単なる薄いラッパーではありません。生のAPIコールにはない、インテントレイヤー、安全性、AIネイティブな設計が追加されています。
比較項目
bgc
直接API
インテント動詞
14の厳選されたインテント動詞
原始エンドポイント
漸進的ディスカバリー

自己記述型インターフェース

ドキュメントを必ずお読みください
HMAC署名

自動

実装必須
レート制限

クライアントサイド内蔵

実装必須
Write-Safety

4つの決定論的ゲート

実装必須
Unix I/O

JSON標準出力(終了コード0)+ 構造化エラー標準エラー出力(終了コード1)

実装必須
キーワード検索

bgc discover --search

実装必須
エスケープハッチ

bgc raw --operationId

実装必須
AI推論

スキルファイルが使用タイミングを指示

実装必須
よくある質問
bitget-agent-cliとは何ですか?
Claude Code、Codex CLI、およびOpenClaw用のCLI(bgc)を提供する、Bitget公式のターミナルAI取引ツールです。UTA v3 APIに基づいて構築されており、14の意図を示す動詞と、discoverおよびrawのメタツールを通じて、7つのドメインにわたる89の操作を公開しています。
Bitgetは、bitget-agent-cli(バイナリ:bgc)という自己記述型CLIを提供しています。これはBitget Unified Trading Account(UTA / v3)APIを基盤とし、14の意図動詞に加え、discoverおよびrawメタツールを通じて、7つのドメイン(market、trade、account、funds、subaccount、loan、tax)にわたる89の操作を提供します。

CLIは段階的な開示により自己記述型となっています。エージェントはbgc discoverを実行して7つのドメインを一覧表示し、ドメインを掘り下げて利用可能な動詞を確認し、動詞から利用可能なアクションを確認し、さらにアクションから正確なパラメーターを確認します。これにより、タスクに必要な範囲だけを読み込みます。各パラメーターの型、列挙値、認証要件、読み取り/書き込みフラグは実行時にライブで照会でき、SDKとの乖離が生じ得る手動管理のスキーマは不要です。
bitget-agent-cli(bgc)は、bashスクリプトやcronジョブに最適なオプションです。プログラムが解析できる構造化されたJSON出力により、UnixスタイルのクリーンなI/Oを生成します。この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)は、人間優先のCLIから改造されたものではなく、AIエージェントのためにゼロから構築されています。その設計理念は次のように明記されています。「ほとんどのCLIは人間のために構築されており、自動化を許容しているに過ぎません。bgcはその逆で、すべての設計上の選択は、シェルからそれを駆動するAIアシスタントのために最適化されています。」

AIエージェント向けの主な機能:

  • 自然言語による発見可能性:discoverコマンドを使用すると、エージェントはドキュメントを読むことなく、段階的な開示(ドメイン → 動詞 → アクション → 正確なパラメーター)を通じて、実行時にAPIサーフェスを探索できます。

  • 決定論的な書き込みの安全性:4つの安全フラグ(--dry-run、--read-only、--confirm、--paper-trading)は純粋なフラグであり、対話型のプロンプトではありません。このCLIは、部分約定時の自動ロールバック(auto-rollback)や、リスクなしでテストするための--paper-tradingフラグもサポートしています。

  • ホストアプリケーションの設定やプラグインは不要:インストールして、AIに何を取引するかを伝えるだけです。

  • 14の意図を示す動詞:実行したいことにマッピングされる厳選された動詞のセット(order、position、marketなど)により、AIが推論しやすくなります。

bitget-agent-cli(bgc)は、Claude Code、Codex CLI、OpenClaw、またはその他のシェルベースAIによって操作され、人間が結果を確認するよう設計されたBitget公式のターミナル取引ツールです。インストールとAPIキー環境変数の設定以外にコーディングは必要ありません。

組み込みの安全制御には以下が含まれます:
--paper-trading:実資金リスクゼロのシミュレーション環境で取引を実行
--read-only:すべての書き込み操作をブロック
--confirm:各書き込み操作の実行前に人間の承認を要求
--dry-run:実行せずに発生する内容をプレビュー
--auto-rollback:部分約定時に未約定部分を自動的にキャンセル
インストール:npm install -g @bitget-ai/bitget-agent-cli + API認証情報を環境変数として設定。

Bitgetは、公式オープンソースAIエコシステムであるBitget Agent Hubの一部として、bitget-agent-cli(bgc)を提供しています。Agent Hubには以下が含まれます:

  • bitget-agent-cli — シェルベースの実行ツール

  • bitget-agent-skill — AIにCLIをいつ、どのように利用するかを教えるツール

  • bitget-agent-mcp — デスクトップAIツール向けMCPサーバー

  • bitget-agent-sdk — 基盤SDK

  • bitget-signal — マーケット分析シグナル

CLIは自動取引戦略向けに特別設計されており、7つのドメインにわたる89の操作を提供します。すべて14の意図動詞を通じて利用できます。自動戦略では、--paper-tradingフラグにより本番運用前にシミュレーション環境でバックテストを実行でき、JSON出力はあらゆる自動化パイプラインに直接統合できます。

bitget-agent-cli(bgc)は、「Unix-clean I/O」と呼ばれる標準化JSON出力、すなわちプログラムで解析可能な出力を提供します。CLIは自動化を前提として設計されており、すべての操作で構造化JSONが返されるため、jqへのパイプ、監視ダッシュボードへの入力、自動ワークフローでの処理に適しています。

AIアシスタントは1セッションあたり数十回CLIを呼び出すため、CLIはnpxではなくnpm install -gでインストールする永続型です。呼び出しごとのオーバーヘッドをゼロにするため、$PATH上に存在する必要があります。この設計により、高頻度の自動化やcronジョブのパイプラインに最適です。

Bitgetは、Bitget Agent Hubを通じて完全なツールスタックを提供しています:

  • CLI — @bitget-ai/bitget-agent-cli(bgc)、ターミナルベースの取引実行ツール

  • Skill — @bitget-ai/bitget-agent-skill、AIにCLIをいつ、どのように利用するかを教えるツール

  • MCP Server — @bitget-ai/bitget-agent-mcp、デスクトップAIツール統合

  • SDK — @bitget-ai/bitget-agent-sdk、カスタム開発向け基盤SDK

  • Signals — @bitget-ai/bitget-signal、マーケット分析シグナル

CLIは実行ツール(bgc)であり、スキルファイルはAIにその利用タイミングと方法を教えます。

開発者向けリソース

AIネイティブCLIで取引を始める

89の操作、14の意図を示す動詞、4つの安全レイヤー — すべてターミナルから。