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 或交易 ID 获取单笔充值记录
5	bithumb deposit list	READ	列出币种充值记录
6	bithumb deposit list-krw	READ	列出 KRW 充值记录
7	bithumb deposit krw	WRITE	发起 KRW 充值请求（需要双重验证）

各命令的参数、示例和输入格式详情，请参阅 deposit-commands.md。

---

操作流程

🛑 必须完成的预检清单 — deposit krw / deposit generate-address

执行本技能中的任何写入操作之前，请按顺序运行以下所有步骤。即使用户说“直接执行”，也不得跳过步骤。在步骤 2 和步骤 3 之间暂停，并征求用户明确确认。

#	命令	用途
0	bithumb config show --json	**只读检查（两种写入操作均须先运行）。**读取当前生效配置文件的 read_only。如果为 true，请在此处停止——不要运行步骤 1–3。列出可执行写入操作的配置文件，并请用户使用 --profile <name> 重新运行（绝不可绕过只读限制——不要自动选择配置文件、切换配置文件或自行禁用 read_only；请参阅检查机制）。每个会话只需检查一次：如果已检查，则跳过。请参阅 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 双重验证	获得明确批准
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_types	bithumb deposit addresses 或 bithumb withdraw chance --currency <c>，在调用任何地址命令之前列出有效的 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（KRW）
申请 KRW 充值（写入操作）	执行上文的预检清单

标识符规则（优先使用 txid）：充值记录以 txid 作为主要标识符。单独的数字 ID 含义不明确（KRW 的 txid 和 deposit_id 都是数字），因此请先查询 --txids → 如果没有结果，再用相同的值重试 --deposit-ids（或向用户确认），然后再判定为“未找到”。包含特殊字符 / 空格 / 逗号的 txid 必须使用单笔 get，不能使用 list。详情见 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 充值双重身份验证：deposit krw 需要 Kakao 身份验证；用户必须在手机上完成双重身份验证。
• 区块确认：加密货币充值需要区块链确认。充值前，请检查 bithumb account wallet-status（位于 bithumb-account 中），确认区块同步状态。
• 充值状态：KRW — PROCESSING / ACCEPTED / CANCELLED。币种状态有所不同（大写，例如 DEPOSIT_PROCESSING）；参见 deposit-commands.md。

全局说明

• 查询充值记录（deposit list / list-krw / get）并向用户展示结果时，务必包含每条记录的 deposit_id——用户之后需要用它查询充值记录。
• 所有命令都需要有效的 API 凭据。
• Bithumb 没有演示模式——所有充值操作都是真实操作（涉及真实资金）。
• --json 返回原始 Bithumb API 响应（适用于任何命令）。