Back to Details

bithumb-withdraw

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bithumb Withdrawal CLI

Bithumb 提现CLI

Crypto and KRW (원화) withdrawals on Bithumb (빗썸): execution, cancellation, history, fee/availability checks, and allowed-address management.
CRITICAL: Crypto withdrawals (
withdraw coin
) are IRREVERSIBLE. A wrong address or network = permanent loss of funds. Always double-check address, network, and amount before executing.
用于在Bithumb（빗썸）平台进行加密货币和韩元（KRW）提现操作：执行提现、取消提现、查看提现历史、查询手续费/提现权限以及管理允许提现地址。
重要提示：加密货币提现（
withdraw coin
）是不可逆的。地址或网络错误将导致资金永久损失。执行提现前务必仔细核对地址、网络和金额。

Tool Routing

工具路由

Writes are CLI-first: prefer the documented 
bithumb ...
CLI over MCP tools (the CLI carries the per-profile read-only gate, account isolation, and terminal reproducibility that writes need). Fall back to MCP only if the CLI is unavailable/fails or the user asks for it; reads may use either path.
写入操作优先使用CLI：优先使用文档中记录的
bithumb ...
CLI命令，而非MCP工具（CLI具备每个配置文件的只读限制、账户隔离和终端可复现性，这些是写入操作所需的特性）。仅当CLI不可用/失败或用户要求时，才退而使用MCP工具；读取操作可任选其中一种方式。

Prerequisites

前置条件

  1. Install: 
    npm install -g @bithumb-official/bithumb-cli
  2. Credentials: 
    export BITHUMB_ACCESS_KEY=...
    and 
    export BITHUMB_SECRET_KEY=...
    . Withdrawal addresses must be pre-registered on Bithumb (for 
    withdraw coin
    ).
  1. 安装：
    npm install -g @bithumb-official/bithumb-cli
  2. 凭证配置：
    export BITHUMB_ACCESS_KEY=...
    和 
    export BITHUMB_SECRET_KEY=...
    。提现地址必须事先在Bithumb平台注册（针对
    withdraw coin
    操作）。

Skill Routing

技能路由

Market data → 
bithumb-market
; assets / wallet status / available withdrawal amount → 
bithumb-account
; orders → 
bithumb-trade
; deposits → 
bithumb-deposit
; audit/diagnostics → 
bithumb-system
; withdrawals → this skill.
A user question about how much can be withdrawn ("출금 가능 금액") routes to 
bithumb-account
. The 
bithumb withdraw chance
command lives here and is run as a withdrawal pre-flight step (fees, limits, supported 
net_type
) — see the checklist below. The two are not in conflict: account answers the question, this skill runs the pre-flight command.
市场数据 → 
bithumb-market
；资产/钱包状态/可用提现金额 → 
bithumb-account
；订单操作 → 
bithumb-trade
；存款操作 → 
bithumb-deposit
；审计/诊断 → 
bithumb-system
；提现操作 → 本技能。
用户关于“可提现金额（출금 가능 금액）”的问题应路由至
bithumb-account
。
bithumb withdraw chance
命令属于本技能，作为提现前的预检步骤（查询手续费、限额、支持的
net_type
）——请查看下方检查清单。两者并不冲突：
bithumb-account
回答金额问题，本技能执行预检命令。

Command Index

命令索引

#CommandTypeDescription
1
bithumb withdraw chance
READWithdrawal availability: balance, fees, limits
2
bithumb withdraw addresses
READList allowed withdrawal addresses
3
bithumb withdraw get
READGet specific withdrawal details
4
bithumb withdraw list
READCoin withdrawal history
5
bithumb withdraw list-krw
READKRW withdrawal history
6
bithumb withdraw coin
WRITEWithdraw crypto (IRREVERSIBLE)
7
bithumb withdraw krw
WRITEWithdraw KRW (2FA required)
8
bithumb withdraw cancel
WRITECancel pending crypto withdrawal
Full parameter tables, input formats, and the workflow example are in references/withdraw-commands.md.
序号命令类型描述
1
bithumb withdraw chance
读取提现权限：余额、手续费、限额
2
bithumb withdraw addresses
读取列出允许的提现地址
3
bithumb withdraw get
读取获取特定提现的详细信息
4
bithumb withdraw list
读取加密货币提现历史
5
bithumb withdraw list-krw
读取韩元提现历史
6
bithumb withdraw coin
写入加密货币提现（不可逆）
7
bithumb withdraw krw
写入韩元提现（需双因素认证）
8
bithumb withdraw cancel
写入取消待处理的加密货币提现
完整的参数表、输入格式和工作流示例请查看references/withdraw-commands.md。

Routing rules

路由规则

User intentCommand
Check if withdrawal is possible & fees / discover 
net_type
bithumb withdraw chance --currency <c> [--net-type <n>]
View allowed withdrawal addresses
bithumb withdraw addresses
Look up one withdrawal by identifier (id/txid)
bithumb withdraw get --currency <c>
Search/filter withdrawal history (no identifier or several)
bithumb withdraw list
View KRW withdrawal history
bithumb withdraw list-krw
Withdraw crypto
bithumb withdraw coin ...
(pre-flight required)
Withdraw KRW
bithumb withdraw krw ...
(pre-flight required)
Cancel pending withdrawal
bithumb withdraw cancel --withdrawal-id <id>
(pre-flight required)
Identifier decision rule (txid-first): deposits/withdrawals use txid as the primary identifier — query 
--txid
/
--txids
first; if empty, retry the same value as 
--withdrawal-id(s)
(or ask the user) before concluding "not found". Details and the 
--txids
JSON-array / special-char-txid handling are in references/withdraw-commands.md.
Read commands (
chance
, 
addresses
, 
get
, 
list
, 
list-krw
) run immediately. All write commands require the pre-flight checklist and explicit user confirmation.
用户意图命令
检查是否可提现及手续费/查看支持的
net_type
bithumb withdraw chance --currency <c> [--net-type <n>]
查看允许的提现地址
bithumb withdraw addresses
通过标识符（id/txid）查询单笔提现
bithumb withdraw get --currency <c>
搜索/过滤提现历史（无标识符或多笔）
bithumb withdraw list
查看韩元提现历史
bithumb withdraw list-krw
提取加密货币
bithumb withdraw coin ...
（需预检）
提取韩元
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
）可立即执行。所有写入命令均需完成预检检查清单并获得用户明确确认。

🛑 Mandatory Pre-flight Checklist — 
withdraw coin
/ 
withdraw krw
/ 
withdraw cancel

🛑 强制预检检查清单 — 
withdraw coin
/ 
withdraw krw
/ 
withdraw cancel

Before any write in this skill, run the steps below in order. Do not skip steps even if the user says "just send it". Stop and ask for explicit user confirmation between step 5 and step 7.
Step 0 (read-only gate) applies to every write here — including 
withdraw cancel
. The heavier balance/address lookups (steps 1–5) are only for 
withdraw coin
/ 
withdraw krw
; for 
withdraw cancel
, run Step 0, confirm the withdrawal ID, then execute.
#CommandPurpose
0
bithumb config show --json
Read-only gate (run first, all writes incl. cancel). Read the effective profile's 
read_only
. If 
true
, stop — do not run later steps. List write-capable profiles and ask the user to re-run with 
--profile <name>
. Never bypass read-only — do not auto-select/switch profiles or disable 
read_only
yourself. See references/read-only-gate.md.
1
bithumb account assets
Confirm sufficient balance
2
bithumb account wallet-status
Confirm withdrawal is enabled (blockchain not under maintenance)
3
bithumb withdraw chance --currency <c> --net-type <n>
Confirm fee, min amount, daily limit, supported 
net_type
4
bithumb withdraw addresses
Confirm destination is in the allowed list (Bithumb requirement)
5
bithumb market fee-inout <currency>
Cross-check withdrawal fee from market side
5b🛂 Classify withdrawal type and collect required paramsOpen references/withdrawal-type-params.md. Confirm whether this is Internal, CODE ID Connect, CODE 개인, CODE 법인, or WHITELIST; collect every required param for that type.
6🤚 Stop. Ask user to confirm: withdrawal type, currency, net_type, amount, address (full string), secondary_address (memo/tag) if applicable, exchange_name if external, and (CODE 개인/법인) receiver_type + all receiver fields
7
bithumb withdraw coin --currency <c> --net-type <n> --amount <a> --address <addr> [--secondary-address <m>] [--exchange-name <e>] [--receiver-type <t> ...receiver fields]
Execute
8
bithumb withdraw list --currency <c> --limit 1
Verify status
Skipping any step (especially 4 / 5 / 6) is the most common cause of failed/lost withdrawals in past QA. The same checklist is mirrored in bithumb-account Cross-Skill Workflows.
After a write, verify: 
withdraw coin
→ 
withdraw list --currency <c> --limit 1
; 
withdraw krw
→ 
withdraw list-krw
; 
withdraw cancel
→ 
withdraw get --currency <c> --withdrawal-id <id>
.
在执行本技能中的任何写入操作之前，请按顺序完成以下步骤。即使用户说“直接操作”，也不要跳过步骤。在步骤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。确认提现类型为内部转账、CODE ID Connect、CODE个人、CODE企业还是白名单；收集该类型所需的所有参数。
6🤚 暂停操作，请求用户确认：提现类型、币种、net_type、金额、完整地址字符串、适用情况下的secondary_address（备注/标签）、外部交易所名称、以及（CODE个人/企业）收款方类型 + 所有收款方字段
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>
。

🛂 Withdrawal Type Params

🛂 提现类型参数

Before 
withdraw coin
, classify the withdrawal type and check references/withdrawal-type-params.md.
Summary:
  • Internal: no 
    --exchange-name
    , no receiver fields.
  • External: 
    --exchange-name
    is required.
  • CODE 개인/법인: 
    --receiver-type
    and all receiver fields are required.
  • --secondary-address
    is required when the asset/network needs a memo/tag.
执行
withdraw coin
之前，请分类提现类型并查看references/withdrawal-type-params.md。
总结：
  • 内部转账：无需
    --exchange-name
    和收款方字段。
  • 外部转账：必须指定
    --exchange-name
    。
  • CODE个人/企业：必须指定
    --receiver-type
    和所有收款方字段。
  • 当资产/网络需要备注/标签时，必须指定
    --secondary-address
    。

Global Notes

全局注意事项

  • When you query withdrawals (
    withdraw list
    / 
    list-krw
    / 
    get
    ) and present the result to the user, always include each entry's 
    withdrawal_id
    — they need it to look up or cancel the withdrawal later.
  • All commands require valid API credentials. Bithumb has no demo mode — every withdrawal is real and involves real funds.
  • --json
    on any command returns the raw Bithumb API response.
  • Always run the 🛑 Mandatory Pre-flight Checklist above for every withdrawal — it is the single safety flow (no shorter sequence).
  • 当查询提现记录（
    withdraw list
    / 
    list-krw
    / 
    get
    ）并向用户展示结果时，请务必包含每条记录的
    withdrawal_id
    ——用户后续需要用它来查询或取消提现。
  • 所有命令均需有效的API凭证。Bithumb无演示模式——每笔提现都是真实操作，涉及真实资金。
  • 在任何命令后添加
    --json
    参数可返回原始Bithumb API响应。
  • 每次提现都必须执行上述🛑强制预检检查清单——这是唯一的安全流程（无简化步骤）。