Back to Details

bithumb-deposit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bithumb Deposit CLI

Bithumb存款CLI

Deposit address management, deposit history, and KRW (원화) deposit requests on Bithumb exchange. Requires API credentials.
在Bithumb交易所进行存款地址管理、存款历史查询以及韩元（원화）存款请求。需要API凭证。

Tool Routing

工具路由

Writes are CLI-first: when both the Bithumb CLI and MCP tools exist, use the 
bithumb ...
CLI for writes (it carries per-profile read-only enforcement, account isolation, and reproducibility that MCP lacks); fall back to MCP only if the CLI is unavailable/fails or the user asks. Reads: either path is fine.
写入操作优先使用CLI：当Bithumb CLI和MCP工具同时存在时，使用
bithumb ...
CLI执行写入操作（它具备MCP所没有的按配置文件只读限制、账户隔离和可复现性）；仅当CLI不可用/失败或用户要求时，才退而使用MCP。读取操作：两种方式均可。

Prerequisites

前置条件

Install the CLI (
npm install -g @bithumb-official/bithumb-cli
) and set credentials (
BITHUMB_ACCESS_KEY
, 
BITHUMB_SECRET_KEY
).
安装CLI（
npm install -g @bithumb-official/bithumb-cli
）并设置凭证（
BITHUMB_ACCESS_KEY
、
BITHUMB_SECRET_KEY
）。

Skill Routing

技能路由

Market data → 
bithumb-market
; account assets / wallet status / deposit availability → 
bithumb-account
; orders → 
bithumb-trade
; withdrawals → 
bithumb-withdraw
; audit logs / diagnostics → 
bithumb-system
. Deposits (this skill).
市场数据 → 
bithumb-market
；账户资产/钱包状态/存款可用状态 → 
bithumb-account
；订单 → 
bithumb-trade
；提现 → 
bithumb-withdraw
；审计日志/诊断 → 
bithumb-system
。存款（本技能）。

Command Index

命令索引

#CommandTypeDescription
1
bithumb deposit addresses
READGet all deposit addresses
2
bithumb deposit address
READGet deposit address for specific currency + network
3
bithumb deposit generate-address
WRITEGenerate new deposit address
4
bithumb deposit get
READGet a single deposit by deposit ID or txid
5
bithumb deposit list
READList coin deposit history
6
bithumb deposit list-krw
READList KRW deposit history
7
bithumb deposit krw
WRITERequest KRW deposit (2FA required)
See deposit-commands.md for per-command parameters, examples, and input-format details.
序号命令类型描述
1
bithumb deposit addresses
读取获取所有存款地址
2
bithumb deposit address
读取获取特定币种+网络的存款地址
3
bithumb deposit generate-address
写入生成新的存款地址
4
bithumb deposit get
读取通过存款ID或txid查询单笔存款记录
5
bithumb deposit list
读取列出加密货币存款历史
6
bithumb deposit list-krw
读取列出韩元存款历史
7
bithumb deposit krw
写入请求韩元存款（需2FA验证）
如需查看各命令的参数、示例和输入格式详情，请参阅deposit-commands.md。

Operation Flow

操作流程

🛑 Mandatory Pre-flight Checklist — 
deposit krw
/ 
deposit generate-address

Before any write operation in this skill, run all of the following in order. Do not skip steps even if the user says "just do it". Stop and ask for explicit user confirmation between step 2 and step 3.
#CommandPurpose
0
bithumb config show --json
Read-only gate (run first, both writes). Read the effective profile's 
read_only
. If 
true
, stop here — do not run steps 1–3. List write-capable profiles and ask the user to re-run with 
--profile <name>
(never bypass read-only — do not auto-select a profile, switch profiles, or disable 
read_only
yourself; see gate). Once-per-session: skip if already checked. See read-only-gate.md.
1For 
generate-address
: discover the valid 
net_type
first (
bithumb deposit addresses
or 
bithumb withdraw chance --currency <c>
). For 
krw
: confirm the exact KRW amount		Avoid wrong-network address generation / wrong amount
2🤚 Stop. Ask user to confirm: for 
generate-address
— currency + net_type; for 
krw
— amount, and that Kakao 2FA will be triggered		Explicit approval
3
generate-address
: 
bithumb deposit generate-address --currency <c> --net-type <n>
/ 
krw
: 
bithumb deposit krw --amount <a> --two-factor-type kakao
Execute
4
generate-address
: 
bithumb deposit address --currency <c> --net-type <n>
(confirm new address) / 
krw
: 
bithumb deposit list-krw
(check status)		Verify after write

🛑 强制预检清单 — 
deposit krw
/ 
deposit generate-address

在执行本技能中的任何写入操作之前，请按顺序完成以下所有步骤。即使用户说“直接操作”，也请勿跳过步骤。在步骤2和步骤3之间，请暂停并请求用户明确确认。
序号命令目的
0
bithumb config show --json
只读限制检查（所有写入操作均需首先执行）。读取当前生效配置文件的
read_only
属性。如果值为
true
，在此停止——请勿执行步骤1-3。列出支持写入操作的配置文件，并请用户使用
--profile <名称>
重新运行（切勿绕过只读限制——请勿自动选择配置文件、切换配置文件或自行禁用
read_only
；请参阅相关限制说明）。每个会话仅需执行一次：如果已检查过可跳过。详情请参阅read-only-gate.md。
1对于
generate-address
：首先查询有效的
net_type
（
bithumb deposit addresses
或 
bithumb withdraw chance --currency <币种>
）。对于
krw
：确认准确的韩元金额		避免生成错误网络的地址/输入错误金额
2🤚 暂停，请求用户确认：对于
generate-address
——币种+net_type；对于
krw
——金额，以及确认将触发Kakao 2FA验证		获取明确批准
3
generate-address
：
bithumb deposit generate-address --currency <币种> --net-type <网络类型>
/ 
krw
：
bithumb deposit krw --amount <金额> --two-factor-type kakao
执行操作
4
generate-address
：
bithumb deposit address --currency <币种> --net-type <网络类型>
（确认新地址） / 
krw
：
bithumb deposit list-krw
（检查状态）		写入操作后验证

Step 1 — Identify deposit action (route to a command)

步骤1 — 确定存款操作（路由至对应命令）

User intentCommand
First time / multi-network coin (USDT, USDC, XRP, etc.) — discover available net_types
bithumb deposit addresses
or 
bithumb withdraw chance --currency <c>
to list valid 
net_type
values before any address call
View all deposit addresses
bithumb deposit addresses
Get address for specific coin + network
bithumb deposit address --currency BTC --net-type BTC
Generate new deposit address (WRITE)run the Pre-flight Checklist above
Look up one deposit by txid / deposit ID (single identifier)
bithumb deposit get --currency BTC --txid "<txid>"
Look up / search deposits by multiple or no identifiers
bithumb deposit list
(coin) / 
bithumb deposit list-krw
(KRW)
Request KRW deposit (WRITE)run the Pre-flight Checklist above
Identifier rule (txid first): deposits use txid as the primary identifier. A bare numeric ID is ambiguous (KRW txid and deposit_id are both numeric), so query 
--txids
first → if empty, retry the same value with 
--deposit-ids
(or ask) before concluding "not found". Special-char/space/comma txids must use single 
get
, not 
list
. Details in deposit-commands.md.
Read commands (
addresses
, 
address
, 
get
, 
list
, 
list-krw
) run immediately — no gate.
用户意图命令
首次操作/多网络币种（USDT、USDC、XRP等） — 查询可用的net_types在调用任何地址相关命令之前，使用
bithumb deposit addresses
或 
bithumb withdraw chance --currency <币种>
列出有效的
net_type
值
查看所有存款地址
bithumb deposit addresses
获取特定币种+网络的地址
bithumb deposit address --currency BTC --net-type BTC
生成新存款地址（写入操作）执行上述预检清单
通过txid/存款ID查询单笔存款记录（单个标识符）
bithumb deposit get --currency BTC --txid "<txid>"
通过多个或无标识符查询/搜索存款记录
bithumb deposit list
（加密货币） / 
bithumb deposit list-krw
（韩元）
请求韩元存款（写入操作）执行上述预检清单
标识符规则（优先使用txid）：存款记录以txid作为主要标识符。纯数字ID存在歧义（韩元txid和deposit_id均为数字），因此请首先使用
--txids
查询→如果无结果，再使用
--deposit-ids
重试相同值（或询问用户），之后再判定“未找到”。包含特殊字符/空格/逗号的txid必须使用单个
get
命令，而非
list
命令。详情请参阅deposit-commands.md。
读取命令（
addresses
、
address
、
get
、
list
、
list-krw
）可立即执行——无需检查限制。

Edge Cases (safety-critical)

边缘情况（安全关键）

🌐 Multi-network coins (USDT, USDC, XRP, etc.): The same 
currency
may have multiple 
net_type
values. Before any deposit address call, discover the real values with 
bithumb deposit addresses
or 
bithumb withdraw chance --currency <c>
. Using a wrong 
net_type
results in permanent loss of funds. Never guess — always discover first.
  • Secondary address (memo/tag): XRP, EOS, ATOM, and similar coins require a 
    secondary_address
    . Always display it when present. Step 4 verify: confirm 
    secondary_address
    is shown for these currencies — if missing, do NOT proceed with the deposit.
  • XRP net_type: 
    --net-type XRP
    may not be valid in all environments. Run 
    bithumb deposit addresses
    first and use the actual registered 
    net_type
    — do not assume 
    XRP
    .
  • KRW deposit 2FA: 
    deposit krw
    requires Kakao authentication; the user must complete 2FA on their phone.
  • Block confirmations: Crypto deposits require blockchain confirmations. Check 
    bithumb account wallet-status
    (in 
    bithumb-account
    ) for block sync status before deposits.
  • Deposit states: KRW — 
    PROCESSING
    / 
    ACCEPTED
    / 
    CANCELLED
    . Coin states differ (UPPERCASE, e.g. 
    DEPOSIT_PROCESSING
    ); see deposit-commands.md.
🌐 多网络币种（USDT、USDC、XRP等）：同一
currency
可能对应多个
net_type
值。在调用任何存款地址相关命令之前，请使用
bithumb deposit addresses
或
bithumb withdraw chance --currency <币种>
查询实际可用值。使用错误的
net_type
会导致资金永久损失。切勿猜测——务必先查询。
  • 二级地址（memo/tag）：XRP、EOS、ATOM等类似币种需要
    secondary_address
    。当存在该地址时，请始终显示它。步骤4验证：确认这些币种的
    secondary_address
    已显示——如果缺失，请勿继续存款操作。
  • XRP的net_type：
    --net-type XRP
    在部分环境中可能无效。请先运行
    bithumb deposit addresses
    ，并使用实际注册的
    net_type
    ——请勿默认使用
    XRP
    。
  • 韩元存款2FA验证：
    deposit krw
    需要Kakao认证；用户必须在手机上完成2FA验证。
  • 区块确认：加密货币存款需要区块链确认。存款前请通过
    bithumb account wallet-status
    （在
    bithumb-account
    中）检查区块同步状态。
  • 存款状态：韩元——
    PROCESSING
    / 
    ACCEPTED
    / 
    CANCELLED
    。加密货币的状态有所不同（大写形式，例如
    DEPOSIT_PROCESSING
    ）；详情请参阅deposit-commands.md。

Global Notes

全局注意事项

  • When you query deposits (
    deposit list
    / 
    list-krw
    / 
    get
    ) and present the result to the user, always include each entry's 
    deposit_id
    — they need it to look up the deposit later.
  • All commands require valid API credentials.
  • Bithumb has no demo mode — all deposit operations are real (real funds).
  • --json
    returns raw Bithumb API response (any command).
  • 当您查询存款记录（
    deposit list
    / 
    list-krw
    / 
    get
    ）并向用户展示结果时，请务必包含每条记录的
    deposit_id
    ——用户后续查询存款时需要用到它。
  • 所有命令均需要有效的API凭证。
  • Bithumb无演示模式——所有存款操作均为真实操作（涉及真实资金）。
  • --json
    参数可返回Bithumb API的原始响应（适用于所有命令）。