mcpField
B
bithumb-account

bithumb-account

github.com/bithumb-officialOther6137 installsUpdated 20w ago
Repository

About bithumb-account

bithumb-account is a read-only CLI skill for Bithumb account and wallet details, intended for users with API credentials. It covers balances, trading availability, wallet status, and API key expiry.

Key features

  1. 01View all currency balances
  2. 02Check market-specific order availability
  3. 03Inspect wallet and transfer status
  4. 04Review API key expiry

Use cases

  1. 01Review balances before trading
  2. 02Check fees and limits for a market
  3. 03Verify wallet availability before deposits or withdrawals
  4. 04Check API key expiration

Install

Copy the command and run it in a terminal.

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

After installing, type/bithumb-accountin Claude Code to confirm it loaded.

Details

From the project README

Bithumb Account CLI

Read-only account state: balances, order chance, wallet status, API keys. Requires API credentials.

Prerequisites

Install @bithumb-official/bithumb-cli and set BITHUMB_ACCESS_KEY / BITHUMB_SECRET_KEY env vars.

Credential Check

Run bithumb system diagnose before any authenticated command. If it fails (connection or auth), STOP — do not retry. Inform the user (in Korean): "인증 실패. API 키가 유효하지 않거나 만료되었을 수 있습니다." and guide them to set/refresh BITHUMB_ACCESS_KEY and BITHUMB_SECRET_KEY; re-run diagnose before retrying.

Skill Routing

Market data → bithumb-market; account/wallet/API keys → this skill; orders → bithumb-trade; deposits → bithumb-deposit; withdrawals → bithumb-withdraw; audit logs & diagnostics → bithumb-system.

Command Index

#CommandTypeDescription
1bithumb account assetsREADAll account assets (KRW + coins)
2bithumb account order-chance --market <m>READOrder availability: balance, fees, limits for a market
3bithumb account wallet-statusREADWallet status: block sync, deposit/withdrawal availability
4bithumb account api-keysREADAPI key list and expiration dates

Audit logs and diagnostics (bithumb system audit / diagnose) are in bithumb-system.

Routing — intent → command

User intentCommand
Check assets (all currencies)bithumb account assets
Check trading availability for a marketbithumb account order-chance --market KRW-BTC
Check wallet/blockchain statusbithumb account wallet-status
Check API key info/expirationbithumb account api-keys

All commands are read-only — run immediately, no confirmation or verification needed.

CLI Reference

account assets — All Assets
bithumb account assets
# → KRW: 1,500,000 | BTC: 0.05 (avg: 135,000,000) | ETH: 1.2 (avg: 4,800,000)

No parameters. Returns every currency held: currency, balance, locked (reserved for open orders), avg_buy_price (volume-weighted), unit_currency.

account order-chance — Order Availability
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 (required): market code. Returns bid_fee/ask_fee, available bid/ask balances, order limits (min/max), market info. Pre-trade essential — call before placing an order to verify balance, fees, and constraints.

account wallet-status — Wallet Status
bithumb account wallet-status
# → BTC: block_state=normal, deposit=true, withdrawal=true

No parameters. Per-currency block sync state and deposit/withdrawal availability. Check before deposit/withdrawal — if block_state is not normal or the operation is disabled (e.g. blockchain maintenance), it will fail.

account api-keys — API Key Info
bithumb account api-keys

No parameters. Returns API keys with expiration dates. Check periodically (or when auth suddenly fails) to avoid unexpected authentication failures.

Cross-Skill Workflows

Pre-trade balance check

User: "BTC 0.01개 살 수 있어?"

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 ...
Pre-withdrawal check (full Mandatory Pre-flight)

User: "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

This pre-flight is mirrored in bithumb-withdraw/SKILL.md as its "🛑 Mandatory Pre-flight Checklist" so it stays visible when only the withdraw skill is active.

Global Notes

  • All commands require valid API credentials and are read-only.
  • Bithumb has no demo/simulated mode — all data reflects real account state.
  • --json returns the raw Bithumb API response.
  • account assets may include zero-balance currencies; locked funds are reserved for open orders and unavailable for new ones.

Comments

Markdown supported