mcpField
B
bithumb-market

bithumb-market

github.com/bithumb-official其他6139 次安装20 周前更新
代码仓库

关于 bithumb-market

bithumb-market 是面向 Bithumb 用户的只读市场数据 CLI 技能，无需 API 凭据即可查询现货行情及交易所公告等信息。它区分交易注意指定与市场警报两套风险标记，按用户意图查询对应数据。

主要功能

  1. 01查询价格、订单簿与近期成交
  2. 02获取分钟及周期 K 线
  3. 03查看市场列表与风险标记
  4. 04查询公告及存取款费用
  5. 05只读访问，无需 API 密钥

适用场景

  1. 01检查某交易对的当前行情
  2. 02比较多个市场的订单簿
  3. 03查看历史 K 线与近期成交
  4. 04核对市场警报或交易所公告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bithumb-official/bithumb-ai-trade-kit --skill bithumb-market

安装后在 Claude Code 中输入/bithumb-market确认已加载。

附带文件references/instrument-commands.mdreferences/price-data-commands.md

详细介绍

Bithumb CEX 市场数据 CLI

合规声明：此技能仅提供原始市场数据，不包含任何策略、建议或优化逻辑。所有输出均为客观数值；如何解读数据以及做出交易决策完全由用户自行负责。

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

技能路由：市场数据 → 此技能；余额/钱包 → bithumb-account；订单 → bithumb-trade；充值 → bithumb-deposit；提现 → bithumb-withdraw；审计/诊断 → bithumb-system。

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

Bithumb 运行着两套独立的交易风险机制。它们使用不同的数据源，一个市场可能出现在其中一套、两套或都不出现，因此调用错误的 API 会返回错误的风险信息。根据用户意图进行路由，且只调用其中一方。

用户意图命令机制
普通市场列表bithumb market markets（省略 isDetails — API 默认值：false）—
明确请求“거래유의 / 유의 종목”bithumb market markets --is-details（market_warning 字段）投资注意指定（유의 종목 지정）— 基于交易所审核、持续有效、定性
“주의 종목 / 경보 / 이상거래 탐지”bithumb market warnings市场警报系统（경보제）— 基于市场数据、自动化、定量检测
意图不明确（例如“유의 상태”“위험한 코인”）说明这两套机制有所不同，确认用户指的是哪一种，然后只调用其中一方—

不要自动调用两个 API。例外：仅当用户明确要求“둘 다 / 전부（两者都要 / 全部）”时。

命令索引

#命令描述
1bithumb market markets列出所有可交易交易对（KRW 和 BTC 市场）
2bithumb market ticker <markets>当前价格行情：最新价格、24 小时最高/最低价、成交量/变化
3bithumb market orderbook <markets>一个或多个市场的订单簿买单/卖单
4bithumb market trades <market>近期公开成交历史
5bithumb market candles-minutes <market>分钟 K 线（1/3/5/10/15/30/60/240 分钟）
6bithumb market candles-days <market>日 K 线
7bithumb market candles-weeks <market>周 K 线
8bithumb market candles-months <market>月 K 线
9bithumb market warnings市场警报系统（경보제）— 自动异常检测（주의 종목）
10bithumb market notices交易所通知/公告列表
11bithumb market fee-inout <currency>按币种查询充值/提现手续费信息

操作流程

步骤 1 — 确定数据类型并加载参考资料

用户意图要加载的参考资料
价格、K 线、订单簿、近期成交{baseDir}/references/price-data-commands.md
市场列表、警报、公告、手续费信息{baseDir}/references/instrument-commands.md

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

边界情况

  • 市场代码格式：{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 Invalid parameter。 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 天的数据。

全局说明

  • 安装：npm install -g @bithumb-official/bithumb-cli。此技能中的所有命令均无需 API 密钥；均为只读操作。
  • Bithumb 支持两个报价市场：KRW（韩元）和 BTC。仅支持现货，不支持衍生品。
  • K 线数据按时间排序。
  • --json 返回原始 Bithumb API 响应（可添加到任意命令中）。

评论

支持 Markdown