bithumb-market

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Bithumb CEX Market Data CLI

Bithumb CEX 市场数据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)".

合规说明：本Skill仅提供原始市场数据，未嵌入任何策略、建议或优化逻辑。所有输出均为客观数值，解读及交易决策完全由用户自行负责。

公开的只读Bithumb市场数据：价格、订单簿、K线、近期交易记录、市场列表、投资注意项目指定（유의 종목 지정）、市场警示系统（경보제 / 주의 종목）、公告及手续费。无需API凭证。

Skill路由：市场数据 → 本Skill；余额/钱包 →

bithumb-account

；订单 →

bithumb-trade

；存款 →

bithumb-deposit

；取款 →

bithumb-withdraw

；审计/诊断 →

bithumb-system

。

风险标记意图路由——投资注意项目指定（유의 종목 지정）vs 市场警示系统（경보제）

Bithumb设有两个独立的交易风险机制，它们使用不同的数据源，一个市场可能属于其中一个、两个都属于或都不属于——因此调用错误的API会得到错误的风险信息。需根据用户意图路由，且仅调用其中一方。

用户意图	命令	机制
普通市场列表	`bithumb market markets` （省略isDetails——API默认值：false）	—
明确请求“거래유의 / 유의 종목”	`bithumb market markets --is-details` （ `market_warning` 字段）	投资注意项目指定（유의 종목 지정）——基于交易所审核，长期有效，定性评估
“주의 종목 / 경보 / 이상거래 탐지”	`bithumb market warnings`	市场警示系统（경보제）——基于市场数据，自动定量检测
模糊请求（如“유의 상태”、“위험한 코인”）	说明两种机制的差异，确认用户需求后仅调用其中一方	—

不要自动调用两个API。例外情况：仅当用户明确要求“둘 다 / 전부 (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


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>

#	命令	描述
1	`bithumb market markets`	列出所有可交易对（韩元KRW和BTC市场）
2	`bithumb market ticker <markets>`	当前行情报价：最新价格、24小时最高价/最低价/成交量/涨跌幅
3	`bithumb market orderbook <markets>`	一个或多个市场的订单簿买卖盘
4	`bithumb market trades <market>`	近期公开交易历史
5	`bithumb market candles-minutes <market>`	分钟级K线（1/3/5/10/15/30/60/240分钟）
6	`bithumb market candles-days <market>`	日线K线
7	`bithumb market candles-weeks <market>`	周线K线
8	`bithumb market candles-months <market>`	月线K线
9	`bithumb market warnings`	市场警示系统（경보제）——自动异常检测（주의 종목）
10	`bithumb market notices`	交易所公告列表
11	`bithumb market fee-inout <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.

步骤1 — 识别数据类型并加载参考文档

用户意图	加载的参考文档
价格、K线、订单簿、近期交易记录	`{baseDir}/references/price-data-commands.md`
市场列表、警示、公告、手续费信息	`{baseDir}/references/instrument-commands.md`

步骤2 — 立即执行。所有命令均为只读，无需确认或验证。

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.

市场代码格式：
```
{quote}-{base}
```
，例如
```
KRW-BTC
```
（而非
```
BTC-KRW
```
）。
反向代码自动修正：如果用户输入反向代码如
```
BTC-KRW
```
，将其转换为
```
KRW-BTC
```
并继续执行，同时告知用户（例如：“已将BTC-KRW转换为KRW-BTC”）。
多行情报价：向
```
ticker
```
/
```
orderbook
```
传递逗号分隔的代码（例如
```
KRW-BTC,KRW-ETH
```
）。
K线单位：分钟级K线仅支持
```
1, 3, 5, 10, 15, 30, 60, 240
```
。
K线数量：最小1条，最大200条，默认1条。
K线
--to
参数：韩国标准时间（KST）本地时间格式
```
YYYY-MM-DDTHH:MM:SS
```
；返回该时间之前的K线。请勿包含时区偏移（
+09:00
、
Z
、
+0900
等）——Bithumb会拒绝带偏移的值并返回HTTP 400参数无效。
```
2026-01-01T00:00:00
```
✓ /
```
...+09:00
```
✗ /
```
...Z
```
✗
交易记录
--to
参数（与K线不同）：仅支持当日时间，格式为
```
HHmmss
```
或
```
HH:mm:ss
```
（00:00:00–23:59:59）。不接受日期（
```
2026-01-01T00:00:00
```
✗）。如需查询过去几日的数据，请使用
```
--days-ago
```
（1–7天）。省略该参数：未使用
```
--days-ago
```
时→当前时间；使用时→指定日期的00:00:00基准。
--converting-price-unit
参数：将非KRW市场（如
```
BTC-ETH
```
）的收盘价转换为KRW；Bithumb仅支持
```
KRW
```
。转换结果（
```
converted_trade_price
```
）仅在
```
--json
```
模式下显示；KRW市场返回
```
null
```
。
fee-inout
命令：使用
```
ALL
```
可一次性获取所有币种的信息。
投资注意项目指定（유의 종목 지정）：
```
markets --is-details
```
→
```
market_warning
```
字段（
```
NONE
```
/
```
CAUTION
```
）。基于交易所审核，长期有效/定性评估；无等级、原因或发布时间。
市场警示系统（경보제 / 주의 종목）：
```
warnings
```
命令的响应。基于市场数据，自动/定量检测；提供
```
warning_step
```
（3个等级：
```
CAUTION
```
/
```
WARNING
```
/
```
DANGER
```
）、
```
warning_type
```
（5种原因）和
```
end_date
```
自动解除时间。
유의 종목 ≠ 경보제：数据源不同——一个市场可能被其中一方标记、双方都标记或都不标记。切勿自动调用两个API；仅调用与用户意图匹配的一方，当意图模糊时需确认。
公告数量：最小1条，最大20条，默认5条。
交易记录分页：使用上一次响应中的
```
--cursor
```
参数；
```
--days-ago
```
可筛选过去1–7天的数据。

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

安装：
```
npm install -g @bithumb-official/bithumb-cli
```
。本Skill中的所有命令均无需API密钥；所有命令均为只读。
Bithumb支持两种计价市场：韩元KRW和BTC。仅支持现货——无衍生品。
K线数据按时间排序。
```
--json
```
参数返回原始Bithumb API响应（可添加至任意命令）。