bithumb-market

Bithumb CEX Market Data CLI

Compliance notice: This skill provides raw market data only. No strategy, recommendation, or optimization logic is embedded. All outputs are objective numerical values; interpretation and trading decisions remain solely with the user.

Public, read-only market data for Bithumb: prices, order books, candles, recent trades, market list, investment caution designation (유의 종목 지정), market alert system (경보제 / 주의 종목), notices, and fees. No API credentials required.

Skill routing: market data → this skill; balance/wallet → bithumb-account; orders → bithumb-trade; deposits → bithumb-deposit; withdrawals → bithumb-withdraw; audit/diagnostics → bithumb-system.

Risk-flag intent routing — investment caution designation (유의 종목 지정) vs market alert system (경보제)

Bithumb runs two independent trading-risk regimes. They use different data sources, and a market may appear in one, both, or neither — so calling the wrong API gives wrong risk info. Route by user intent and call only ONE side.

User intent	Command	Regime
Plain market list	bithumb market markets (omit isDetails — API default: false)	—
Explicit "거래유의 / 유의 종목" request	bithumb market markets --is-details (market_warning field)	investment caution designation (유의 종목 지정) — exchange-review-based, standing, qualitative
"주의 종목 / 경보 / 이상거래 탐지"	bithumb market warnings	market alert system (경보제) — market-data-based, automatic, quantitative detection
Ambiguous (e.g., "유의 상태", "위험한 코인")	Explain the two regimes differ, confirm which the user means, then call only one	—

Do NOT auto-call both APIs. Exception: only when the user explicitly asks for "둘 다 / 전부 (both / all)".

Command Index

#	Command	Description
1	bithumb market markets	List all tradeable pairs (KRW and BTC markets)
2	bithumb market ticker <markets>	Current price ticker: last price, 24h high/low/vol/change
3	bithumb market orderbook <markets>	Order book bids/asks for one or more markets
4	bithumb market trades <market>	Recent public trade history
5	bithumb market candles-minutes <market>	Minute candles (1/3/5/10/15/30/60/240 min)
6	bithumb market candles-days <market>	Daily candles
7	bithumb market candles-weeks <market>	Weekly candles
8	bithumb market candles-months <market>	Monthly candles
9	bithumb market warnings	market alert system (경보제) — automatic anomaly detection (주의 종목)
10	bithumb market notices	Exchange notice/announcement list
11	bithumb market fee-inout <currency>	Deposit/withdrawal fee info by currency

Operation Flow

Step 1 — Identify data type and load reference

User intent	Reference to load
Price, candles, order book, recent trades	{baseDir}/references/price-data-commands.md
Market list, warnings, notices, fee info	{baseDir}/references/instrument-commands.md

Step 2 — Run immediately. All commands are read-only; no confirmation and no verification needed.

Edge Cases

• Market code format: {quote}-{base}, e.g., KRW-BTC (not BTC-KRW).
• Reversed-code auto-correction: if the user inputs a reversed code like BTC-KRW, convert it to KRW-BTC and proceed, informing the user (e.g., "Converted BTC-KRW → KRW-BTC").
• Multiple tickers: pass comma-separated codes to ticker/orderbook (e.g., KRW-BTC,KRW-ETH).
• Candle units: minute candles support 1, 3, 5, 10, 15, 30, 60, 240 only.
• Candle count: min 1, max 200, default 1.
• Candle --to: KST naive datetime YYYY-MM-DDTHH:MM:SS; returns candles before this time. Do NOT include a timezone offset (+09:00, Z, +0900, etc.) — Bithumb rejects offset-bearing values with HTTP 400 Invalid parameter. 2026-01-01T00:00:00 ✓ / ...+09:00 ✗ / ...Z ✗
• Trades --to (differs from candles): time-of-day only, HHmmss or HH:mm:ss (00:00:00–23:59:59). Date is not accepted (2026-01-01T00:00:00 ✗). For past days use --days-ago (1–7). Omitted: without --days-ago → current time; with → that day's 00:00:00 base.
• --converting-price-unit: converts a non-KRW market's (e.g., BTC-ETH) close to KRW; Bithumb supports KRW only. Result (converted_trade_price) appears in --json only; KRW markets return null.
• fee-inout: use ALL to get all currencies at once.
• investment caution designation (유의 종목 지정): markets --is-details → market_warning field (NONE / CAUTION). Exchange-review-based, standing/qualitative; no step, reason, or release time.
• market alert system (경보제 / 주의 종목): warnings response. Market-data-based, automatic/quantitative; provides warning_step (3 levels: CAUTION/WARNING/DANGER), warning_type (5 reasons), and end_date auto-release time.
• 유의 종목 ≠ 경보제: different data sources — a market may be flagged in one, both, or neither. Never auto-call both APIs; call only the side matching user intent, and confirm when ambiguous.
• Notices count: min 1, max 20, default 5.
• Trades pagination: use --cursor from the previous response; --days-ago filters 1–7 days back.

Global Notes

• Install: npm install -g @bithumb-official/bithumb-cli. No API key required for any command in this skill; all are read-only.
• Bithumb supports two quote markets: KRW (원화) and BTC. Spot only — no derivatives.
• Candle data is sorted by time.
• --json returns the raw Bithumb API response (add to any command).