bithumb-withdraw について
bithumb-withdraw は Bithumb CLI で暗号資産と KRW の出金を確認・管理するスキルです。取り消せない送金や出金条件、許可済みの宛先に対応するため、事前確認と承認を必須とします。
主な機能
- 01出金可否、手数料、上限の確認
- 02許可済みアドレスと出金履歴の確認
- 03暗号資産と KRW の出金申請
- 04保留中の暗号資産出金のキャンセル
- 05書き込み前の事前確認
活用シーン
- 01出金前の手数料と対応ネットワークの確認
- 02登録済みアドレスへの暗号資産出金
- 03保留中の出金の照会やキャンセル
MCP 対応
書き込みには Bithumb CLI を優先し、CLI が利用できない場合や失敗した場合、または依頼がある場合は MCP に切り替えます。読み取りにはどちらも利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bithumb-official/ bithumb-ai-trade-kit --skill bithumb-withdrawインストール後、Claude Code で/bithumb-withdrawを入力して読み込まれたか確認します。
同梱ファイルreferences/read-only-gate.md
詳細
Bithumb 出金 CLI
Bithumb(빗썸)での暗号資産および KRW(ウォン)の出金:実行、キャンセル、履歴、手数料・利用可否の確認、許可済みアドレスの管理。
CRITICAL:暗号資産の出金(
withdraw coin)は取り消せません。アドレスやネットワークを誤ると、資金を永久に失います。実行前に、アドレス、ネットワーク、金額を必ず再確認してください。
ツールの振り分け
書き込み操作はCLI を優先します。MCP ツールより、ドキュメントに記載された bithumb ... CLI を優先してください。CLI には、書き込み操作に必要なプロファイル単位の読み取り専用ゲート、アカウントの分離、ターミナルでの再現性が備わっています。CLI を利用できない、または失敗する場合や、ユーザーから指定された場合にのみ MCP にフォールバックしてください。読み取り操作はいずれの方法でも実行できます。
前提条件
- インストール:
npm install -g @bithumb-official/bithumb-cli - 認証情報:
export BITHUMB_ACCESS_KEY=...およびexport BITHUMB_SECRET_KEY=...。出金アドレスは Bithumb に事前登録しておく必要があります(withdraw coinの場合)。
スキルの振り分け
市場データ → bithumb-market;資産/ウォレットの状態/出金可能額 → bithumb-account;注文 → bithumb-trade;入金 → bithumb-deposit;監査・診断 → bithumb-system;出金 → このスキル。
出金可能額についてのユーザーの質問(「출금 가능 금액」)は
bithumb-accountに振り分けます。bithumb withdraw chanceコマンドはこちらにあり、出金前の確認ステップとして実行します(手数料、上限、サポート対象のnet_type)。詳しくは以下のチェックリストを参照してください。この2つは矛盾しません。質問への回答は account が担当し、このスキルは出金前の確認コマンドを実行します。
コマンド一覧
| # | コマンド | 種類 | 説明 |
|---|---|---|---|
| 1 | bithumb withdraw chance | READ | 出金の利用可否:残高、手数料、上限 |
| 2 | bithumb withdraw addresses | READ | 許可済み出金アドレスの一覧 |
| 3 | bithumb withdraw get | READ | 特定の出金の詳細を取得 |
| 4 | bithumb withdraw list | READ | 暗号資産の出金履歴 |
| 5 | bithumb withdraw list-krw | READ | KRW の出金履歴 |
| 6 | bithumb withdraw coin | WRITE | 暗号資産を出金(取り消し不可) |
| 7 | bithumb withdraw krw | WRITE | KRW を出金(2FA 必須) |
| 8 | bithumb withdraw cancel | WRITE | 処理待ちの暗号資産出金をキャンセル |
パラメーターの全一覧、入力形式、ワークフローの例は references/withdraw-commands.md を参照してください。
振り分けルール
| ユーザーの目的 | コマンド |
|---|---|
出金の可否と手数料を確認する/net_type を調べる | bithumb withdraw chance --currency <c> [--net-type <n>] |
| 許可済み出金アドレスを表示する | bithumb withdraw addresses |
| 識別子(id/txid)で特定の出金を検索する | bithumb withdraw get --currency <c> |
| 出金履歴を検索・絞り込む(識別子がない、または複数ある場合) | bithumb withdraw list |
| KRW の出金履歴を表示する | bithumb withdraw list-krw |
| 暗号資産を出金する | bithumb withdraw coin ...(事前確認が必須) |
| KRW を出金する | bithumb withdraw krw ...(事前確認が必須) |
| 処理待ちの出金をキャンセルする | bithumb withdraw cancel --withdrawal-id <id>(事前確認が必須) |
識別子の判断ルール(txid を優先):入金・出金では、主な識別子として txid を使用します。まず --txid/--txids で照会し、結果が空の場合は、同じ値を --withdrawal-id(s) として再試行するか、ユーザーに確認してから「見つかりません」と判断してください。--txids の JSON 配列や特殊文字を含む txid の扱いについては、references/withdraw-commands.md を参照してください。
読み取りコマンド(chance、addresses、get、list、list-krw)はすぐに実行できます。すべての書き込みコマンドでは、出金前のチェックリストを実施し、ユーザーから明示的な確認を得る必要があります。
🛑 必須の事前チェックリスト — withdraw coin / withdraw krw / withdraw cancel
このスキルで書き込みを行う前に、以下の手順を順番どおりに実行してください。ユーザーが「そのまま送って」と言っても、手順を省略してはいけません。手順 5 と手順 7 の間で必ず停止し、ユーザーに明示的な確認を求めてください。
手順 0(読み取り専用ゲート)は、ここで行うすべての書き込みに適用されます。withdraw cancel も対象です。より詳細な残高/アドレスの確認(手順 1~5)は withdraw coin / withdraw krw の場合のみ必要です。withdraw cancel の場合は手順 0 を実行し、出金 ID を確認してから実行してください。
| # | コマンド | 目的 |
|---|---|---|
| 0 | bithumb config show --json | 読み取り専用ゲート(最初に実行。キャンセルを含むすべての書き込みが対象)。 有効なプロファイルの read_only を確認します。true の場合は停止し、後続の手順を実行しないでください。書き込み可能なプロファイルを一覧表示し、ユーザーに --profile <name> を指定して再実行するよう依頼してください。読み取り専用を決して回避してはいけません。自分でプロファイルを自動選択/切り替えたり、read_only を無効にしたりしないでください。references/read-only-gate.md を参照してください。 |
| 1 | bithumb account assets | 残高が十分であることを確認 |
| 2 | bithumb account wallet-status | 出金が有効であることを確認(ブロックチェーンがメンテナンス中でないこと) |
| 3 | bithumb withdraw chance --currency <c> --net-type <n> | 手数料、最小額、1 日あたりの上限、対応する net_type を確認 |
| 4 | bithumb withdraw addresses | 出金先が許可リストに含まれていることを確認(Bithumb の要件) |
| 5 | bithumb market fee-inout <currency> | マーケット側の出金手数料と照合 |
| 5b | 🛂 出金タイプを分類し、必要なパラメーターを収集 | references/withdrawal-type-params.md を開きます。Internal、CODE ID Connect、CODE 개인、CODE 법인、WHITELIST のいずれに該当するかを確認し、そのタイプで必要なパラメーターをすべて収集してください。 |
| 6 | 🤚 停止して、ユーザーに確認を求める:出金タイプ、通貨、net_type、金額、アドレス(完全な文字列)、該当する場合は secondary_address(メモ/タグ)、外部の場合は exchange_name、および(CODE 개인/법인の場合)receiver_type とすべての受取人フィールド | |
| 7 | bithumb withdraw coin --currency <c> --net-type <n> --amount <a> --address <addr> [--secondary-address <m>] [--exchange-name <e>] [--receiver-type <t> ...receiver fields] | 実行 |
| 8 | bithumb withdraw list --currency <c> --limit 1 | ステータスを確認 |
いずれかの手順を省略すると(特に 4/5/6)、過去の QA で最もよく見られた出金の失敗/紛失の原因になります。同じチェックリストは bithumb-account のクロススキルワークフロー にも記載されています。
書き込み後に確認してください:withdraw coin → withdraw list --currency <c> --limit 1、withdraw krw → withdraw list-krw、withdraw cancel → withdraw get --currency <c> --withdrawal-id <id>。
🛂 出金タイプのパラメーター
withdraw coin の前に、出金タイプを分類し、
references/withdrawal-type-params.md を確認してください。
概要:
- Internal:
--exchange-nameと受取人フィールドは不要です。 - External:
--exchange-nameが必須です。 - CODE 개인/법인:
--receiver-typeとすべての受取人フィールドが必須です。 - 資産/ネットワークでメモ/タグが必要な場合は、
--secondary-addressが必須です。
全般的な注意事項
- 出金を照会(
withdraw list/list-krw/get)し、結果をユーザーに提示する場合は、各項目のwithdrawal_idを必ず含めてください。後で出金を照会またはキャンセルする際に必要です。 - すべてのコマンドで有効な API 認証情報が必要です。Bithumb にデモモードはありません。すべての出金は実際のものであり、実際の資金を伴います。
- どのコマンドでも
--jsonを指定すると、Bithumb API の生レスポンスが返されます。 - 出金のたびに、上記の🛑必須の事前チェックリストを必ず実行してください。これが唯一の安全な手順であり、より短い手順はありません。