bithumb-deposit

Bithumb 入金 CLI

Bithumb 取引所での入金アドレス管理、入金履歴、KRW（ウォン）の入金リクエストに対応します。API 認証情報が必要です。

ツールの使い分け

書き込み操作は CLI を優先します。Bithumb CLI と MCP ツールの両方が利用できる場合は、書き込みには bithumb ... CLI を使用してください（MCP にはない、プロファイルごとの読み取り専用制御、アカウント分離、再現性を備えています）。CLI が利用できない場合や失敗した場合、またはユーザーから依頼があった場合に限り、MCP に切り替えます。読み取り操作は、どちらを使ってもかまいません。

前提条件

CLI をインストールし（npm install -g @bithumb-official/bithumb-cli）、認証情報を設定してください（BITHUMB_ACCESS_KEY、BITHUMB_SECRET_KEY）。

スキルの使い分け

市場データ → bithumb-market；口座資産／ウォレットの状態／入金可否 → bithumb-account；注文 → bithumb-trade；出金 → bithumb-withdraw；監査ログ／診断 → bithumb-system。入金 → このスキル。

コマンド一覧

#	コマンド	種別	説明
1	bithumb deposit addresses	READ	すべての入金アドレスを取得
2	bithumb deposit address	READ	指定した通貨とネットワークの入金アドレスを取得
3	bithumb deposit generate-address	WRITE	新しい入金アドレスを生成
4	bithumb deposit get	READ	入金 ID または txid を指定して単一の入金を取得
5	bithumb deposit list	READ	暗号資産の入金履歴を一覧表示
6	bithumb deposit list-krw	READ	KRW の入金履歴を一覧表示
7	bithumb deposit krw	WRITE	KRW の入金をリクエスト（2FA が必要）

コマンドごとのパラメーター、例、入力形式の詳細については、deposit-commands.md を参照してください。

---

操作の流れ

🛑 必須の事前確認チェックリスト — deposit krw ／ deposit generate-address

このスキルで書き込み操作を行う前に、以下をすべて順番に実行してください。ユーザーが「すぐ実行して」と言っていても、手順を省略しないでください。手順 2 と手順 3 の間で必ず停止し、ユーザーに明示的な確認を求めてください。

#	コマンド	目的
0	bithumb config show --json	読み取り専用ゲート（両方の書き込み操作で最初に実行）。 有効なプロファイルの read_only を確認します。true の場合はここで停止し、手順 1～3 を実行しないでください。書き込み可能なプロファイルを一覧表示し、ユーザーに --profile <name> を付けて再実行するよう依頼してください（読み取り専用設定を回避してはいけません。自動でプロファイルを選択したり、プロファイルを切り替えたり、read_only を無効にしたりしないでください。ゲートを参照）。セッションごとに 1 回実行します。すでに確認済みの場合は省略してください。read-only-gate.md を参照してください。
1	generate-address の場合：有効な net_type を先に確認します（bithumb deposit addresses または bithumb withdraw chance --currency <c>）。krw の場合：正確な KRW 金額を確認します	誤ったネットワークのアドレス生成／誤った金額を防止
2	🤚 停止してユーザーに確認を求めます：generate-address の場合は通貨と net_type、krw の場合は金額と、Kakao 2FA が実行されることを確認します	明示的な承認
3	generate-address：bithumb deposit generate-address --currency <c> --net-type <n> ／ krw：bithumb deposit krw --amount <a> --two-factor-type kakao	実行
4	generate-address：bithumb deposit address --currency <c> --net-type <n>（新しいアドレスを確認）／ krw：bithumb deposit list-krw（ステータスを確認）	書き込み後の検証

ステップ 1 — 入金操作を特定する（コマンドに振り分ける）

ユーザーの意図	コマンド
初回／複数ネットワークに対応するコイン（USDT、USDC、XRP など） — 利用可能な net_type を確認する	アドレスを取得する前に、bithumb deposit addresses または bithumb withdraw chance --currency <c> を実行して、有効な net_type の値を一覧表示する
すべての入金アドレスを表示する	bithumb deposit addresses
特定のコインとネットワークのアドレスを取得する	bithumb deposit address --currency BTC --net-type BTC
新しい入金アドレスを生成する（書き込み）	上記の実行前チェックリストを実行する
txid または入金 ID で 1 件の入金を検索する（識別子は 1 つ）	bithumb deposit get --currency BTC --txid "<txid>"
複数または識別子なしで入金を検索する	bithumb deposit list（コイン）／bithumb deposit list-krw（KRW）
KRW 入金をリクエストする（書き込み）	上記の実行前チェックリストを実行する

識別子のルール（txid を優先）：入金では txid が主識別子です。数値のみの ID は曖昧です（KRW の txid と deposit_id はどちらも数値です）。そのため、まず --txids で照会し、結果が空の場合は、見つからないと判断する前に、同じ値で --deposit-ids を指定して再試行する（または確認する）必要があります。特殊文字、空白、カンマを含む txid には list ではなく、単一の get を使用してください。詳細は deposit-commands.md を参照してください。

読み取りコマンド（addresses、address、get、list、list-krw）はゲートなしで直ちに実行できます。

---

エッジケース（安全上重要）

🌐 複数ネットワークに対応するコイン（USDT、USDC、XRP など）：同じ currency に複数の net_type の値が対応する場合があります。入金アドレスを取得する前に、bithumb deposit addresses または bithumb withdraw chance --currency <c> を実行して実際の値を確認してください。誤った net_type を使用すると、資金が永久に失われます。推測せず、必ず先に確認してください。

• セカンダリアドレス（メモ／タグ）：XRP、EOS、ATOM などのコインでは、secondary_address が必要です。存在する場合は必ず表示してください。ステップ 4 の確認時に、これらの通貨で secondary_address が表示されていることを確認してください。表示されていない場合は、入金を進めないでください。
• XRP の net_type：--net-type XRP は、すべての環境で有効とは限りません。まず bithumb deposit addresses を実行し、登録されている実際の net_type を使用してください。XRP と決めつけないでください。
• KRW 入金の 2FA：deposit krw には Kakao 認証が必要です。ユーザーはスマートフォンで 2FA を完了する必要があります。
• ブロック承認：暗号資産の入金には、ブロックチェーン上での承認が必要です。入金前に、bithumb-account の bithumb account wallet-status でブロックの同期状態を確認してください。
• 入金状態：KRW — PROCESSING／ACCEPTED／CANCELLED。コインの状態は異なります（大文字表記、例：DEPOSIT_PROCESSING）。deposit-commands.md を参照してください。

全般的な注意事項

• 入金を照会（deposit list／list-krw／get）して結果をユーザーに提示する際は、後から入金を検索できるよう、各項目の deposit_id を必ず含めてください。
• すべてのコマンドには、有効な API 認証情報が必要です。
• Bithumb にデモモードはありません。すべての入金操作は実際の操作です（実際の資金を使用します）。
• --json は、生の Bithumb API レスポンスを返します（すべてのコマンド）。