SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsbithumb-market

bithumb-market

Data & analytics

View repository

Updated 10-15 17:26

About this skill

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).