bitget

Bitget スキル

bgc CLI ツールを使って、現物、先物、アカウント、マージン、コピートレーディング、コンバート、運用、P2P、ブローカーの各操作など、Bitget 取引所の全機能を利用できます。

ステップ 1：前提条件を確認する

bgc --version

見つからない場合は、ユーザーに npm install -g bitget-client を案内してください。

プライベートエンドポイント（アカウント情報、取引、送金）には、認証情報を設定する必要があります。 ~/.claude/skills/bitget-skill/references/auth-setup.md を参照してください。

ステップ 2：コマンドを実行する

bgc <module> <tool_name> [--param value ...]

出力はすべて JSON です。レスポンスには常に次の内容が含まれます。

• data — 実際の結果
• endpoint — 呼び出された API
• requestTime — リクエストのタイムスタンプ

ツールとパラメーターの全一覧については、次を参照してください。 ~/.claude/skills/bitget-skill/references/commands.md

目次があるため、該当するモジュールのセクションに直接移動してください。

取引インターフェースについて、パラメーターの詳細な説明、使用例、サンプルを含むリファレンスドキュメントは、次にあります。 ~/.claude/skills/bitget-skill/references/trading/

ファイル	内容
trading/spot-place-order.md	現物の指値／成行／一括注文、TP／SL のプリセット
trading/spot-cancel-orders.md	現物注文の個別、一括、または全件キャンセル
trading/spot-modify-order.md	現物注文の変更（キャンセルして再発注）
trading/spot-get-orders.md	現物の未約定注文／履歴注文の照会
trading/spot-plan-orders.md	現物のトリガー注文／プラン注文（ストップロス、ブレイクアウト）
trading/futures-place-order.md	先物注文、ワンウェイ／ヘッジモード、TP／SL
trading/futures-modify-order.md	保留中の先物注文の変更：TP／SL、価格、数量の調整
trading/futures-cancel-orders.md	先物注文のキャンセル
trading/futures-get-orders.md	先物注文と約定の照会
trading/futures-positions.md	現在／過去のポジション、PnL、清算価格
trading/futures-leverage-config.md	レバレッジ、マージンモード、ポジションモードの設定

取引コマンドを組み立てる前に、必ず該当する取引リファレンスを読んでください。

先物：ポジション決済と TP／SL のクイックルール

先物の決済注文または TP／SL 注文を発注する前に、必ずポジションを確認してください。

bgc futures futures_get_positions --productType USDT-FUTURES --symbol BTCUSDT

注：holdSide（long／short）と posMode（one_way_mode／hedge_mode）を確認してください。

決済方向のルール（最もよくある間違い）

ポジション	決済時の side	追加パラメーター
ロング（ワンウェイモード）	sell	reduceOnly: "YES"
ショート（ワンウェイモード）	buy	reduceOnly: "YES"
ロング（ヘッジモード）	sell	tradeSide: "close"
ショート（ヘッジモード）	buy	tradeSide: "close"

ショートを決済するために売るのは誤りです。ショートのポジションがさらに増えます。

TP／SL の設定方法

1. エントリー時に設定する：新規注文の presetStopSurplusPrice／presetStopLossPrice
2. エントリー後に追加／変更する：futures_modify_order で newPresetStopSurplusPrice／newPresetStopLossPrice を指定します。注文はキャンセルされません。プリセットを削除するには "0" を渡します
3. 手動の指値注文＋reduceOnly：目標価格で別途、決済用の指値注文を発注します（代替手段として使用）

futures_modify_order を使用する前に、trading/futures-modify-order.md を読んでください。

モジュールのクイックリファレンス

モジュール	用途
spot	現物価格、オーダーブック、ローソク足、現物注文
futures	無期限先物価格、ポジション、先物注文、レバレッジ
account	残高、入金、出金、送金、サブアカウント
margin	マージン資産、借入／返済、マージン注文
copytrading	トレーダーのフォロー、ポジションのコピー。**注：**コピーしたポジションは通常の先物とは別です。管理には futures_place_order ではなく、copy_get_positions と copy_close_position を使用してください
convert	あるコインから別のコインへのコンバート。**2 段階の手順が必要です：**まず convert_get_quote を呼び出します（見積もり ID とレートが返され、有効期間は約 10 秒です）。次に convert_execute を呼び出します。実行前に、必ず見積もりレートをユーザーに提示してください
earn	貯蓄／ステーキング商品、申し込み／償還
p2p	P2P の加盟店と注文
broker	ブローカーのサブアカウントと API キー

書き込み操作：必ず事前に確認する

書き込み操作：はいと表示されたコマンドを実行する前に、実行内容を要約し、ユーザーに確認してください。 これには、注文の発注、注文のキャンセル、送金、出金、レバレッジの設定、借り入れ、Earn 商品の償還が含まれます。

確認の例：

"BTCUSDT で 0.01 BTC を 70,000 ドルで購入する指値注文を発注します。よろしいですか？"

書き込み操作をユーザーに知らせずに実行してはいけません。

**出金時の安全対策：**確認プロンプトでは、必ずチェーン名と送金先アドレスを提示してください。チェーンの選択を誤ると取り消せません。ユーザーがチェーンを指定していない場合は、利用可能なチェーンを一覧表示し、続行する前に確認してください。

**成行買いの注文サイズ：**現物の成行買いでは、size はベースコインではなくクオートコイン（USDT）で指定します。ほぼゼロの注文が意図せず実行されるのを防ぐため、成行買い注文を作成する前に、ユーザーの意図を確認してください。

エラーの処理

bgc が "ok": false を返した場合は、復旧方法として error.suggestion を確認してください。 よくある解決方法：~/.claude/skills/bitget-skill/references/error-codes.md

認証情報が不足している場合（AUTH_MISSING）は、設定が必要な環境変数を正確にユーザーに提示してください。

出力の表示

• 価格／ティッカー：シンボル、最終価格、24 時間の変動率、出来高を見やすく要約して表示します
• 注文一覧：orderId、シンボル、売買区分、価格、サイズ、ステータスを表形式で表示します
• 残高：利用可能額と凍結額をコインごとに一覧表示します。少額残高（< 0.0001）は省略します
• 先物ポジション：必ずシンボル、売買方向（ロング／ショート）、サイズ、エントリー価格、マーク価格、未実現損益、清算価格、レバレッジを表示します。清算価格を省略してはいけません
• 資金調達率：現在のレート、年率換算レート、次回の決済時刻を表示します
• ユーザーが求めていない生データ：JSON 全体を出力せず、要約します

使用例

# Public market data (no credentials needed)
bgc spot spot_get_ticker --symbol BTCUSDT
bgc futures futures_get_ticker --productType USDT-FUTURES --symbol BTCUSDT
bgc futures futures_get_funding_rate --productType USDT-FUTURES --symbol BTCUSDT

# Account queries (requires credentials)
bgc account get_account_assets
bgc spot spot_get_orders --status open
bgc futures futures_get_positions --productType USDT-FUTURES

# Write operations (confirm before running)
bgc spot spot_place_order --orders '[{"symbol":"BTCUSDT","side":"buy","orderType":"limit","price":"70000","size":"0.01"}]'
bgc futures futures_set_leverage --productType USDT-FUTURES --symbol BTCUSDT --marginCoin USDT --leverage 10
bgc account transfer --fromAccountType spot --toAccountType futures_usdt --coin USDT --amount 100

デモ取引モード

ユーザーが取引の練習、戦略のテストを希望する場合、または「demo」「paper trading」「simulated trading」を明示的に依頼した場合は、デモモードを使用します。

**セットアップ：**Bitget Demo API Key が必要です。セットアップの詳細は ~/.claude/skills/bitget-skill/references/demo-trading.md を参照してください。

bgc CLI の場合：bgc の直後、最初のフラグとして --paper-trading を追加します。

bgc --paper-trading spot spot_get_ticker --symbol BTCUSDT
bgc --paper-trading futures futures_get_positions --productType USDT-FUTURES
bgc --paper-trading account get_account_assets

**MCP ツールの場合：**MCP サーバーは --paper-trading を付けて起動する必要があります。ユーザーが MCP 経由でデモモードを使おうとしていて、サーバーがそのフラグなしで起動されている場合は、--paper-trading を付けて再起動する必要があることを伝えてください。

**重要なルール：**デモモードでは、セッション内のすべての bgc コマンドに --paper-trading を追加してください。同じセッションでデモ用コマンドと実取引用コマンドを混在させてはいけません。