| name | bithumb-account |
| description | Read account state on Bithumb: balances (KRW/coin), order chance (available balance for trading), withdrawal chance (available withdrawal amount), wallet status, blockchain sync, deposit/withdrawal availability, block height/updated time, and API key info. Requires API credentials. 빗썸 계좌 잔고, 주문 가능 금액, 출금 가능 금액, 지갑 상태, 입출금 현황(가능 여부·블록 갱신시각·블록 동기화), API 키 정보를 조회합니다. 잔고·주문 가능 금액·출금 가능 금액·지갑 상태·입출금 가능 여부·블록 갱신시각·API 키 조회 관련 요청에 사용하세요. |
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
| # | Command | Type | Description |
|---|
| 1 | bithumb account assets | READ | All account assets (KRW + coins) |
| 2 | bithumb account order-chance --market <m> | READ | Order availability: balance, fees, limits for a market |
| 3 | bithumb account wallet-status | READ | Wallet status: block sync, deposit/withdrawal availability |
| 4 | bithumb account api-keys | READ | API key list and expiration dates |
Audit logs and diagnostics (bithumb system audit / diagnose) are in bithumb-system.
Routing — intent → command
| User intent | Command |
|---|
| Check assets (all currencies) | bithumb account assets |
| Check trading availability for a market | bithumb account order-chance --market KRW-BTC |
| Check wallet/blockchain status | bithumb account wallet-status |
| Check API key info/expiration | bithumb account api-keys |
All commands are read-only — run immediately, no confirmation or verification needed.
CLI Reference
account assets — All Assets
bithumb account assets
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
--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
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.
