# Bithumb Market

> 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를 사용하세요.

- Skill: `bithumb-official/bithumb-market` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bithumb-official/bithumb-market`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bithumb-official/bithumb-market/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: bithumb-official (https://skillmd.com/u/bithumb-official)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bithumb-official/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).