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).
1---2name: bithumb-market3description: Read-only public market data for Bithumb: prices, ticker, order book, candles (minute/day/week/month), recent trades, market list, virtual asset warnings, notices, and fees. No API credentials required. Do NOT use for wallet/blockchain status or deposit-withdrawal availability — use bithumb-account. 빗썸 시세·호가·캔들·체결 내역·마켓 목록·유의 종목·경보제·공지사항·수수료 등 공개 시장 데이터를 조회합니다. 인증 불필요. 빗썸 시세·차트·호가·체결 내역·유의 종목·경보제 관련 요청에 사용하세요. 입출금 현황·블록 갱신시각·블록 동기화·입출금 가능 여부는 bithumb-account를 사용하세요.4---56# Bithumb CEX Market Data CLI78> **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.910Public, **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.**1112**Skill routing**: market data → this skill; balance/wallet → `bithumb-account`; orders → `bithumb-trade`; deposits → `bithumb-deposit`; withdrawals → `bithumb-withdraw`; audit/diagnostics → `bithumb-system`.1314**Risk-flag intent routing — investment caution designation (유의 종목 지정) vs market alert system (경보제)**1516Bithumb 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.1718| User intent | Command | Regime |19|---|---|---|20| Plain market list | `bithumb market markets` (omit isDetails — API default: false) | — |21| Explicit "거래유의 / 유의 종목" request | `bithumb market markets --is-details` (`market_warning` field) | investment caution designation (유의 종목 지정) — exchange-review-based, standing, qualitative |22| "주의 종목 / 경보 / 이상거래 탐지" | `bithumb market warnings` | market alert system (경보제) — market-data-based, automatic, quantitative detection |23| Ambiguous (e.g., "유의 상태", "위험한 코인") | Explain the two regimes differ, confirm which the user means, then call only one | — |2425Do NOT auto-call both APIs. Exception: only when the user explicitly asks for "둘 다 / 전부 (both / all)".2627## Command Index2829| # | Command | Description |30|---|---|---|31| 1 | `bithumb market markets` | List all tradeable pairs (KRW and BTC markets) |32| 2 | `bithumb market ticker <markets>` | Current price ticker: last price, 24h high/low/vol/change |33| 3 | `bithumb market orderbook <markets>` | Order book bids/asks for one or more markets |34| 4 | `bithumb market trades <market>` | Recent public trade history |35| 5 | `bithumb market candles-minutes <market>` | Minute candles (1/3/5/10/15/30/60/240 min) |36| 6 | `bithumb market candles-days <market>` | Daily candles |37| 7 | `bithumb market candles-weeks <market>` | Weekly candles |38| 8 | `bithumb market candles-months <market>` | Monthly candles |39| 9 | `bithumb market warnings` | market alert system (경보제) — automatic anomaly detection (주의 종목) |40| 10 | `bithumb market notices` | Exchange notice/announcement list |41| 11 | `bithumb market fee-inout <currency>` | Deposit/withdrawal fee info by currency |4243## Operation Flow4445**Step 1 — Identify data type and load reference**4647| User intent | Reference to load |48|---|---|49| Price, candles, order book, recent trades | `{baseDir}/references/price-data-commands.md` |50| Market list, warnings, notices, fee info | `{baseDir}/references/instrument-commands.md` |5152**Step 2 — Run immediately.** All commands are read-only; no confirmation and no verification needed.5354## Edge Cases5556- **Market code format**: `{quote}-{base}`, e.g., `KRW-BTC` (not `BTC-KRW`).57- **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").58- **Multiple tickers**: pass comma-separated codes to `ticker`/`orderbook` (e.g., `KRW-BTC,KRW-ETH`).59- **Candle units**: minute candles support `1, 3, 5, 10, 15, 30, 60, 240` only.60- **Candle count**: min 1, max 200, default 1.61- **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` ✗62- **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.63- **`--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`.64- **`fee-inout`**: use `ALL` to get all currencies at once.65- **investment caution designation (유의 종목 지정)**: `markets --is-details` → `market_warning` field (`NONE` / `CAUTION`). Exchange-review-based, standing/qualitative; no step, reason, or release time.66- **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.67- **유의 종목 ≠ 경보제**: 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.68- **Notices count**: min 1, max 20, default 5.69- **Trades pagination**: use `--cursor` from the previous response; `--days-ago` filters 1–7 days back.7071## Global Notes7273- Install: `npm install -g @bithumb-official/bithumb-cli`. No API key required for any command in this skill; all are read-only.74- Bithumb supports two quote markets: KRW (원화) and BTC. Spot only — no derivatives.75- Candle data is sorted by time.76- `--json` returns the raw Bithumb API response (add to any command).
bithumb-official