mcpField
B
bithumb-account

bithumb-account

github.com/bithumb-official其他6137 次安装20 周前更新
代码仓库

关于 bithumb-account

bithumb-account 是面向持有 API 凭据用户的 Bithumb 账户只读命令行技能，涵盖余额、交易可用额度、钱包状态和 API 密钥到期信息。

主要功能

  1. 01查看所有币种余额
  2. 02查询市场下单可用额度
  3. 03查看钱包及转账状态
  4. 04检查 API 密钥到期时间

适用场景

  1. 01交易前核对账户余额
  2. 02查询市场手续费和限额
  3. 03存款或提现前确认钱包状态
  4. 04检查 API 密钥有效期

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bithumb-official/bithumb-ai-trade-kit --skill bithumb-account

安装后在 Claude Code 中输入/bithumb-account确认已加载。

详细介绍

Bithumb 账户 CLI

只读账户状态：余额、下单机会、钱包状态、API 密钥。需要 API 凭据。

前置条件

安装 @bithumb-official/bithumb-cli，并设置 BITHUMB_ACCESS_KEY / BITHUMB_SECRET_KEY 环境变量。

凭据检查

在执行任何需要身份验证的命令前，先运行 bithumb system diagnose。如果失败（连接或身份验证问题），立即停止，不要重试。用韩语告知用户："인증 실패. API 키가 유효하지 않거나 만료되었을 수 있습니다."，并指导他们设置或更新 BITHUMB_ACCESS_KEY 和 BITHUMB_SECRET_KEY；重试前重新运行 diagnose。

技能路由

市场数据 → bithumb-market；账户/钱包/API 密钥 → 此技能；订单 → bithumb-trade；充值 → bithumb-deposit；提现 → bithumb-withdraw；审计日志和诊断 → bithumb-system。

命令索引

#命令类型说明
1bithumb account assetsREAD所有账户资产（KRW + 币种）
2bithumb account order-chance --market <m>READ下单可用情况：指定市场的余额、费用和限额
3bithumb account wallet-statusREAD钱包状态：区块同步、充值/提现可用性
4bithumb account api-keysREADAPI 密钥列表及到期日期

审计日志和诊断（bithumb system audit / diagnose）位于 bithumb-system。

路由 — 意图 → 命令

用户意图命令
查看资产（所有币种）bithumb account assets
查看某个市场的交易可用情况bithumb account order-chance --market KRW-BTC
查看钱包/区块链状态bithumb account wallet-status
查看 API 密钥信息/到期时间bithumb account api-keys

所有命令均为只读——立即运行，无需确认或验证。

CLI 参考

account assets — 所有资产
bithumb account assets
# → KRW: 1,500,000 | BTC: 0.05 (avg: 135,000,000) | ETH: 1.2 (avg: 4,800,000)

无需参数。返回持有的每种货币：currency、balance、locked（为未完成订单预留）、avg_buy_price（按成交量加权）、unit_currency。

account order-chance — 下单可用情况
bithumb account order-chance --market KRW-BTC
# → bid_fee: 0.0025 | ask_fee: 0.0025 | available KRW: 1,500,000 | available BTC: 0.05

--market（必填）：市场代码。返回 bid_fee/ask_fee、可用买入/卖出余额、订单限额（最小值/最大值）和市场信息。交易前必查——下单前调用，以确认余额、费用和限制。

account wallet-status — 钱包状态
bithumb account wallet-status
# → BTC: block_state=normal, deposit=true, withdrawal=true

无需参数。返回每种货币的区块同步状态，以及充值/提现可用情况。充值/提现前请检查——如果 block_state 状态异常，或相关操作已禁用（例如区块链维护），操作将会失败。

account api-keys — API 密钥信息
bithumb account api-keys

无需参数。返回 API 密钥及其到期日期。请定期检查（或在身份验证突然失败时检查），以避免意外的身份验证失败。

跨技能工作流

交易前检查余额

用户："我能买 0.01 个 BTC 吗？"

1. bithumb-account  bithumb account order-chance --market KRW-BTC  → check available KRW & fees
2. bithumb-market   bithumb market ticker KRW-BTC                  → current price
        ↓ user approves
3. bithumb-trade    bithumb trade place --market KRW-BTC --side bid ...
提现前检查（完整的强制预检）

用户："我想提取 BTC，可以吗？" / "提取 BTC 前帮我检查一下所有事项"

1. bithumb-account    bithumb account assets                           → check BTC balance
2. bithumb-account    bithumb account wallet-status                    → check BTC withdrawal enabled
3. bithumb-withdraw   bithumb withdraw chance --currency BTC --net-type BTC
                                                                              → fee, min, daily limit, net_type
4. bithumb-withdraw   bithumb withdraw addresses                       → confirm destination is allowed-list
5. bithumb-market     bithumb market fee-inout BTC                     → cross-check fee from market side
        ↓ user explicitly confirms (currency, net_type, full address, amount, memo if applicable)
6. bithumb-withdraw   bithumb withdraw coin --currency BTC --net-type BTC --amount ...
7. bithumb-withdraw   bithumb withdraw list --currency BTC --limit 1   → verify status

此预检也见于 bithumb-withdraw/SKILL.md 中的“🛑 强制预检清单”，以便仅启用提现技能时也能查看。

全局说明

  • 所有命令都需要有效的 API 凭据，且均为只读。
  • Bithumb 没有演示/模拟模式——所有数据都反映真实账户状态。
  • --json 返回原始 Bithumb API 响应。
  • account assets 可能包含余额为零的货币；locked 资金为未完成订单预留，无法用于新订单。

评论

支持 Markdown