bithumb-market

Original：🇺🇸 English

Translated

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

1installs

Sourcebithumb-official/bithumb-ai-trade-kit

Added on2026-07-27

NPX Install

npx skill4agent add bithumb-official/bithumb-ai-trade-kit bithumb-market

SKILL.md Content

View Translation Comparison →

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


bithumb market markets
bithumb market ticker <markets>
bithumb market orderbook <markets>
bithumb market trades <market>
bithumb market candles-minutes <market>
bithumb market candles-days <market>
bithumb market candles-weeks <market>
bithumb market candles-months <market>
bithumb market warnings
bithumb market notices
bithumb market fee-inout <currency>

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