Bitget Agent Hub

Bitget Agent Hub — Bitget 公式 AI 取引・市場データエコシステム

Claude、Cursor、Codex、ChatGPT、その他あらゆる MCP 互換 AI エージェントを Bitget アカウントや市場データに接続する、公式オープンソースツールキットです。

クイックスタート · エコシステム · インストーラー · 取引ツール · 市場ツール · アーキテクチャ · セキュリティ · よくある質問

---

概要

Bitget Agent Hub は Bitget 公式の AI エージェントツールキットです。暗号資産とトークン化された米国株の取引に対応し、取引や市場分析に関する Bitget UTA v3 の 89 の操作を Claude、Cursor、Codex、ChatGPT、その他の AI エージェントで利用できます。

個人トレーダー、クオンツ開発者、自然言語で暗号資産取引所を操作したいすべての方のために開発されています。

このリポジトリは、エコシステム全体への一元的な入り口です。詳細については、各パッケージのリポジトリをご覧ください。

---

クイックスタート

何をしたいですか？

What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
|     |
|     +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
|     |   -> install agent-cli + agent-skill
|     |
|     +-- Desktop AI (Claude Desktop / Cursor / Continue)
|         -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
|     -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
      -> install bitget-agent-sdk

AI を使ってインストールする

上のユースケースツリーで必要なパッケージを確認できます。ターミナルツールをまとめてセットアップするには、次の内容をターミナル AI（Claude Code、Codex、OpenClaw）に貼り付けてください。

Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.

これにより、bgc CLI と取引・市場シグナルのスキルがインストールされ、Claude Code、Codex、OpenClaw にデプロイされます。デスクトップ AI（Cursor、Claude Desktop、ChatGPT）では、代わりに bitget-agent-mcp を使用します。取引ツールをご覧ください。パッケージごとのコマンド、ロールバック、フラグについては、以下のインストーラーをご覧ください。

---

エコシステム

Bitget Agent Hub は、単一の役割を担う 5 つのコアパッケージで構成されています。このリポジトリには、それらをまとめてインストール・アップグレードするメタツール bitget-agent-installer も含まれています。

取引ツール（API キーが必要）

パッケージ	最適な用途	機能
bitget-agent-sdk	開発者	UTA v3 の 89 の操作に対応する基盤 TypeScript SDK
bitget-agent-cli	ターミナル AI	Claude Code、Codex、OpenClaw 向けの bgc コマンドラインツール
bitget-agent-mcp	デスクトップ AI	Claude Desktop、Cursor、Windsurf、ChatGPT 向けの MCP サーバー
bitget-agent-skill	ターミナル AI	bgc を正しく使う方法を教える AI 推論ガイド

市場ツール（アカウント不要）

パッケージ	機能
bitget-signal	マクロ、オンチェーン、センチメント、テクニカル、ニュースに関する 5 つの市場分析スキル

すべてのパッケージは MIT ライセンスで、無料で利用できます。競合することなく、複数を併用できます。

---

インストーラー

@bitget-ai/bitget-agent-installer は、エコシステム全体を管理するメタツールです。1 つのコマンドで、Bitget Agent Hub のパッケージを AI ツールにインストール、アップグレード、ロールバック、デプロイできます。各パッケージを個別にインストールしたり、各スキルのセットアップを手動で実行したりする必要はありません。

npx @bitget-ai/bitget-agent-installer

引数なしで実行すると対話型メニューが表示されます。または、コマンドを直接渡すこともできます（以下を参照）。

管理対象

パッケージ	役割
bitget-agent-cli	ターミナルで取引するための bgc CLI
bitget-agent-skill	ターミナル AI 向けの取引推論ガイド
bitget-signal	市場分析スキル（API キー不要）

デスクトップ AI では bitget-agent-mcp を使用します。これはグローバルにインストールするのではなく、MCP クライアントの設定に登録します。MCP パッケージからセットアップしてください。bitget-agent-sdk はライブラリの依存関係であり、個別にインストールする必要はありません。

利用する理由

• エコシステム全体を 1 つのコマンドで管理 — すべてのパッケージをまとめてインストール、アップグレード、ロールバックできます。
• 常に最新の状態 — 各パッケージの最新公開バージョンを自動で解決します。バージョンを固定する必要がなく、パッケージ間でバージョンが異なっていても問題なく動作します。
• スキルのデプロイ機能を内蔵 — --target を使って、スキルを Claude Code、Codex、OpenClaw に直接組み込みます。
• 元に戻せます — 任意のパッケージを、以前公開されたバージョンにロールバックできます。
• 安全に事前確認 — --dry-run を指定すると、実行せずにすべてのコマンドを表示します。
• 軽量 — npx で実行できる、依存関係のない単一スクリプトです。npm または pnpm を自動検出します。

コマンド

コマンド	動作
(引数なし)	対話型メニュー — アップグレード、ロールバック、またはスキルのデプロイ
upgrade-all [--target <tools>]	管理対象のすべてのパッケージを最新バージョンにインストールまたは更新
upgrade <pkg> [--target <tools>]	1 つのパッケージを最新バージョンにインストールまたは更新
rollback <pkg> --to <version>	パッケージを特定の公開バージョンに切り替え
install [pkg] [--target <tools>]	インストール済みパッケージのスキルを AI ツールにデプロイ

フラグ

• --target <tools> — スキルのデプロイ先：claude、codex、openclaw、all（カンマ区切り。デフォルトは claude）
• --dry-run — コマンドを実行せずにプレビュー
• --version · --help

例

# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli

# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0

# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex

# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run

---

取引ツール

AI エージェントに Bitget での取引を自動で任せる

Bitget Agent Hub の取引ツールは、14 個の厳選されたインテント動詞を通じて 89 個の UTA v3 オペレーションを提供します。

AI への質問	動作
「BTC を 0.1、市場価格で購入して」	現物の成行注文
「BTC のロングポジションを 10 倍のレバレッジで開いて」	先物ポジション
「残高を確認して」	アカウントの概要
「USDT を先物口座に振り替えて」	内部資金振替
「未約定の注文をすべてキャンセルして」	一括キャンセル

AI 環境を選択

AI の利用環境…	インストールするパッケージ
ターミナル AI：Claude Code、Codex CLI、OpenClaw	bitget-agent-cli + bitget-agent-skill
デスクトップ AI：Claude Desktop、Cursor、Continue、Windsurf、ChatGPT Desktop	bitget-agent-mcp

はじめに

1. bitget.com/api-management で Bitget API キーを作成します
2. インストーラーウィザードを実行するか、各パッケージのドキュメントに従います
3. AI に 「利用可能な Bitget ツールを教えて」 と質問して、インストールを確認します

初めてですか？ デモ API キーを作成し、実際の資金を使う前に --paper-trading を指定して練習してください。

---

市場ツール

AI エージェントに市場をリアルタイムで監視・分析させる

bitget-signal は、市場分析スキルを 5 つ追加します。Bitget アカウントも API キーも必要ありません。

AI への質問	スキル
「FRB の政策は BTC にどのような影響を与えていますか？」	macro-analyst
「クジラはオンチェーンで資産を移動させていますか？」	market-intel
「市場は恐怖と強欲のどちらに傾いていますか？」	sentiment-analyst
「BTC の RSI は買われすぎですか？」	technical-analysis
「今日、暗号資産で重要なニュースは何ですか？」	news-briefing

はじめに

npx @bitget-ai/bitget-signal --target all

AI ツールを再起動してから、市場の状況について質問してください。

今後の予定

Bitget 限定のシグナル：

• top-trader-flow：トップコピートレードリーダーのポジション状況
• derivatives-structure：無期限先物のベーシスとタームストラクチャー
• large-flow-detect：クジラ級の注文を検出

---

アーキテクチャ

graph TD
    subgraph Surfaces
        A[bitget-agent-cli<br/>Terminal AI]
        B[bitget-agent-mcp<br/>Desktop AI MCP]
        C[bitget-agent-skill<br/>AI Reasoning Guide]
    end
    
    subgraph Foundation
        D[bitget-agent-sdk<br/>TypeScript SDK]
    end
    
    subgraph MarketAnalysis
        E[bitget-signal<br/>5 Analysis Skills]
    end
    
    A --> D
    B --> D
    C --> A
    D --> F[Bitget UTA v3 API]
    E --> G[Public Market-Data MCP<br/>no API key]
    
    style D fill:#f9f,stroke:#333,stroke-width:2px
    style F fill:#bbf,stroke:#333,stroke-width:2px

仕組み：

1. SDK（bitget-agent-sdk）：89 の操作、HMAC 署名、レート制限を備えた基盤レイヤー
2. CLI（bitget-agent-cli）：SDK を基盤とするターミナルのコマンドラインツール
3. MCP（bitget-agent-mcp）：SDK を基盤とするデスクトップ AI サーバー
4. スキル（bitget-agent-skill）：CLI を正しく使う方法をターミナル AI に教えます
5. シグナル（bitget-signal）：公開鍵不要の市場データ MCP サービスによる独立した市場分析

---

対応する操作

Bitget UTA v3 API に基づき、14 の厳選されたインテント動詞を通じて 89 の操作を利用できます。

モジュール	デフォルト	インテント動詞	API キーが必要
market	✅	market	いいえ（公開データ）
trade	✅	order、position、strategy_order	はい
account	✅	account_overview、transfer_funds、…	はい
strategy	—	raw 経由	はい
cryptoloans	—	loan	はい
tax	—	tax	はい

strategy_order は trade モジュールに含まれます。戦略注文の発注は、取引が有効な場合にエージェントが想定する取引機能だからです。strategy モジュールのその他の操作は、引き続き raw から利用できます。

メタツールとして、操作を調べる discover と、operationId を指定して任意の操作を呼び出す raw もあります。

bgc discover（または各インターフェースの discover）を使えば、いつでも最新のカタログを確認できます。

---

セキュリティ

認証情報の保護

• ✅ マシンから外部に送信されません：API キーは環境変数からのみ読み込まれます
• ✅ ローカル署名：認証が必要なリクエストはすべて、プロセス内で HMAC-SHA256 により署名されます
• ✅ .env の解析なし：漏えいを防ぐため、ツールは .env ファイルを読み込みません
• ✅ プロキシなし：Bitget の公式 API に直接接続します

安全モード

• --read-only：起動時にすべての書き込みツールを無効にします。AI は注文や送金を実行できません
• --paper-trading：Bitget のデモ環境に接続します。実際の資金は使用されません
• レート制限：クライアント側に組み込まれたスロットリングにより、API の不正利用を防ぎます

ベストプラクティス

1. テストにはまずデモ用 API キーを使います
2. クエリを確認するため、--read-only モードから始めます
3. 認証情報をバージョン管理にコミットしないでください
4. API キーは 90 日ごとにローテーションします

---

ドキュメント

トピック	ドキュメント
はじめに	docs/getting-started.md
エコシステムのアーキテクチャ	docs/architecture.md

CLI フラグ、MCP クライアント設定、SDK API、シグナルスキルなど、パッケージごとのリファレンスは各パッケージのリポジトリにあります（上記のエコシステムの表を参照）。最新のツール一覧は、いつでも bgc discover（または各インターフェースの discover）で確認できます。

---

リンク

• Bitget：bitget.com
• API ドキュメント：bitget.com/api-doc
• Model Context Protocol：modelcontextprotocol.io
• Bitget の AI リポジトリ一覧：github.com/Bitget-AI

---

FAQ

Bitget Agent Hub とは何ですか？

Bitget Agent Hub は、Bitget 公式のオープンソース AI エージェントエコシステムです。Bitget の暗号資産取引機能とリアルタイム市場データを、Claude、Cursor、Codex、ChatGPT などの AI エージェントに接続します。14 の厳選されたインテント動詞を通じて 89 の UTA v3 操作を利用できるほか、アカウント不要の市場分析スキルも利用できます。

どのパッケージをインストールすればよいですか？

使用する AI ツールによって異なります。

• ターミナル AI（Claude Code、Codex）→ bitget-agent-cli + bitget-agent-skill
• デスクトップ AI（Claude Desktop、Cursor）→ bitget-agent-mcp
• 市場分析のみ → bitget-signal（API キーは不要です）
• カスタムツールを開発する開発者 → bitget-agent-sdk

AIを使って暗号資産を自動売買できますか？

はい。インストール後、対応するAIツールに「0.1 BTCを購入」や「レバレッジ10倍でBTCのロングポジションを建てる」と指示すると、AIがBitgetアカウントで直接取引を実行します。安全に練習するには、--paper-trading モードを使用してください。

APIキーを接続しても安全ですか？

はい。認証情報は以下のとおりです。

• 環境変数からのみ読み取られます
• サーバー経由でプロキシされることはありません
• HMAC-SHA256でローカルに署名されます
• ログに記録されたり、ディスクに書き込まれたりすることはありません

誤注文を防ぐにはどうすればよいですか？

起動時に --read-only を追加してください。書き込み可能なツールはすべて完全に削除されるため、AIはそれらを認識したり、呼び出したりできません。

対応しているAIツールはどれですか？

Claude Desktop、Claude Code、Cursor、Codex CLI、Continue、Windsurf、ChatGPT Desktop、OpenClaw、およびMCP互換のクライアントに対応しています。

無料ですか？

すべてのパッケージはMITライセンスで、無料でご利用いただけます。bitget-signal はBitgetがメンテナンスしており、無料でご利用いただけます。APIキーもアカウントも不要です。

すべてを更新するにはどうすればよいですか？

npx @bitget-ai/bitget-agent-installer を実行してアップグレードを選択するか、次を実行してください。

npx @bitget-ai/bitget-agent-installer upgrade-all --target all

---

コントリビューション

Issueやプルリクエストを歓迎します。

• バグの報告や機能のリクエスト：GitHub Issues
• セキュリティに関する問題：[email protected] までメールでご連絡ください（公開の場には投稿しないでください）

---

ライセンス

MIT License — 個人利用および商用利用は無料です。クレジット表記は歓迎しますが、必須ではありません。

---

_{⚠️ リスクに関する免責事項：暗号資産やトークン化株式の取引には重大なリスクが伴います。AIエージェントがお客様に代わって行う注文については、お客様ご自身がすべての責任を負います。実際の取引を始める前に、必ず --read-only モードと --paper-trading モードを使用して安全に練習してください。}

_{Bitget Agent HubはBitget公式のオープンソースプロジェクトです · Bitget AIエコシステムの一部です · トレーダー、開発者、AI愛好家のために開発されています}