bithumb-account

Bithumb アカウント CLI

読み取り専用のアカウント状態：残高、注文可能情報、ウォレット状態、API キー。API 認証情報が必要です。

前提条件

@bithumb-official/bithumb-cli をインストールし、環境変数 BITHUMB_ACCESS_KEY ／ BITHUMB_SECRET_KEY を設定します。

認証情報の確認

認証が必要なコマンドを実行する前に、bithumb system diagnose を実行してください。失敗した場合（接続または認証エラー）は、中止してください。再試行してはいけません。 ユーザーに（韓国語で）「인증 실패. API 키가 유효하지 않거나 만료되었을 수 있습니다.」と伝え、BITHUMB_ACCESS_KEY と BITHUMB_SECRET_KEY の設定または更新を案内してください。再試行する前に、diagnose を再実行してください。

スキルの振り分け

マーケットデータ → bithumb-market；アカウント／ウォレット／API キー → このスキル；注文 → bithumb-trade；入金 → bithumb-deposit；出金 → bithumb-withdraw；監査ログと診断 → bithumb-system。

コマンド一覧

#	コマンド	種別	説明
1	bithumb account assets	読み取り	すべてのアカウント資産（KRW ＋コイン）
2	bithumb account order-chance --market <m>	読み取り	注文可能情報：指定市場の残高、手数料、上限・下限
3	bithumb account wallet-status	読み取り	ウォレット状態：ブロック同期、入金／出金の可否
4	bithumb account api-keys	読み取り	API キー一覧と有効期限

監査ログと診断（bithumb system audit / diagnose）については、bithumb-system を参照してください。

---

振り分け — 意図 → コマンド

ユーザーの意図	コマンド
資産を確認する（全通貨）	bithumb account assets
指定市場の取引可能状況を確認する	bithumb account order-chance --market KRW-BTC
ウォレット／ブロックチェーンの状態を確認する	bithumb account wallet-status
API キー情報／有効期限を確認する	bithumb account api-keys

すべてのコマンドは読み取り専用です。確認や検証は不要なので、そのまま実行してください。

---

CLI リファレンス

account assets — 全資産

bithumb account assets
# → KRW: 1,500,000 | BTC: 0.05 (avg: 135,000,000) | ETH: 1.2 (avg: 4,800,000)

パラメーターはありません。保有するすべての通貨について、currency、balance、locked（未約定注文用に予約済み）、avg_buy_price（出来高加重平均）、unit_currency を返します。

account order-chance — 注文可能情報

bithumb account order-chance --market KRW-BTC
# → bid_fee: 0.0025 | ask_fee: 0.0025 | available KRW: 1,500,000 | available BTC: 0.05

--market（必須）：市場コード。bid_fee／ask_fee、利用可能な買い／売り残高、注文上限・下限、市場情報を返します。取引前に必ず確認してください。残高、手数料、制約を確認するため、注文を出す前に実行してください。

account wallet-status — ウォレット状態

bithumb account wallet-status
# → BTC: block_state=normal, deposit=true, withdrawal=true

パラメーターはありません。通貨ごとのブロック同期状態と、入金／出金の可否を返します。入金／出金の前に確認してください。block_state が正常でない場合、または操作が無効になっている場合（例：ブロックチェーンのメンテナンス中）、操作は失敗します。

account api-keys — API キー情報

bithumb account api-keys

パラメーターはありません。有効期限付きの API キーを返します。予期しない認証エラーを避けるため、定期的に（または認証が突然失敗したときに）確認してください。

スキル横断ワークフロー

取引前の残高確認

ユーザー：「BTC を 0.01 個買えますか？」

1. bithumb-account  bithumb account order-chance --market KRW-BTC  → check available KRW & fees
2. bithumb-market   bithumb market ticker KRW-BTC                  → current price
        ↓ user approves
3. bithumb-trade    bithumb trade place --market KRW-BTC --side bid ...

出金前の確認（必須の事前確認をすべて実施）

ユーザー：「BTC を出金したいのですが、可能ですか？」／「BTC を出金する前にすべて確認してください」

1. bithumb-account    bithumb account assets                           → check BTC balance
2. bithumb-account    bithumb account wallet-status                    → check BTC withdrawal enabled
3. bithumb-withdraw   bithumb withdraw chance --currency BTC --net-type BTC
                                                                              → fee, min, daily limit, net_type
4. bithumb-withdraw   bithumb withdraw addresses                       → confirm destination is allowed-list
5. bithumb-market     bithumb market fee-inout BTC                     → cross-check fee from market side
        ↓ user explicitly confirms (currency, net_type, full address, amount, memo if applicable)
6. bithumb-withdraw   bithumb withdraw coin --currency BTC --net-type BTC --amount ...
7. bithumb-withdraw   bithumb withdraw list --currency BTC --limit 1   → verify status

この事前確認は bithumb-withdraw/SKILL.md の「🛑 必須の事前確認チェックリスト」にも記載されているため、出金スキルのみが有効な場合にも確認できます。

---

全般的な注意事項

• すべてのコマンドには有効な API 認証情報が必要で、読み取り専用です。
• Bithumb にはデモ／シミュレーションモードがありません。すべてのデータは実際のアカウント状態を反映します。
• --json は Bithumb API の生レスポンスを返します。
• account assets に残高がゼロの通貨が含まれる場合があります。locked の資金は未約定注文用に予約されており、新しい注文には利用できません。