bithumb-withdraw

Bithumb 提币 CLI

在 Bithumb（빗썸）提取加密货币和 KRW（韩元）：执行、取消、历史记录、手续费/可用性检查以及允许的地址管理。

重要：加密货币提币（withdraw coin）不可逆。地址或网络错误会导致资金永久损失。执行前务必仔细核对地址、网络和金额。

工具路由

写操作优先使用 CLI：优先使用文档所述的 bithumb ... CLI，而非 MCP 工具（CLI 提供写操作所需的按配置文件只读限制、账户隔离和终端可复现性）。仅当 CLI 不可用/运行失败，或用户提出要求时，才回退到 MCP；读取操作可使用任一路径。

先决条件

1. 安装：npm install -g @bithumb-official/bithumb-cli
2. 凭据：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）——详见下方清单。两者并不冲突：账户技能回答问题，本技能运行提币前检查命令。

命令索引

#	命令	类型	说明
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（需要双重验证）
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>	确认手续费、最低金额、每日限额和支持的 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	验证状态

在过去的 QA 中，跳过任何步骤（尤其是步骤 4／5／6）是导致提现失败或资金丢失的最常见原因。相同的清单也收录在 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 响应。
• 每次提现都必须运行上方的 🛑 强制预检清单——这是唯一的安全流程（没有更短的步骤）。