mcpField
B
bithumb-market

bithumb-market

github.com/bithumb-officialその他6139 回インストール20 週間前に更新
リポジトリ

bithumb-market について

bithumb-marketは、Bithumbの市場データを取得する読み取り専用CLIスキルです。API認証情報なしで現物データやお知らせを確認でき、取引注意指定と自動検知の市場アラートを区別します。

主な機能

  1. 01価格、板、最近の約定の取得
  2. 02分足および各期間のローソク足取得
  3. 03市場一覧とリスク表示の確認
  4. 04お知らせと入出金手数料の確認
  5. 05APIキー不要の読み取り専用アクセス

活用シーン

  1. 01市場の現在価格の確認
  2. 02複数市場の板の比較
  3. 03ローソク足と最近の約定の確認
  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 の公開読み取り専用市場データ：価格、注文板、ローソク足、最近の取引、市場一覧、投資注意銘柄指定（유의 종목 지정）、市場警報システム（경보제／주의 종목）、お知らせ、手数料。API 認証情報は不要です。

スキルの振り分け：市場データ → このスキル、残高／ウォレット → bithumb-account、注文 → bithumb-trade、入金 → bithumb-deposit、出金 → bithumb-withdraw、監査／診断 → bithumb-system。

リスクフラグの意図に基づく振り分け — 投資注意銘柄指定（유의 종목 지정）と市場警報システム（경보제）

Bithumb には、独立した2つの取引リスク制度があります。使用するデータソースが異なり、市場がいずれか一方、両方、またはどちらにも該当しない場合があるため、誤った API を呼び出すとリスク情報も誤ったものになります。ユーザーの意図に応じて振り分け、片方だけを呼び出してください。

ユーザーの意図コマンド制度
通常の市場一覧bithumb market markets（isDetails を省略 — API のデフォルト：false）—
「거래유의 / 유의 종목」の明示的なリクエストbithumb market markets --is-details（market_warning フィールド）投資注意銘柄指定（유의 종목 지정） — 取引所の審査に基づく、継続的かつ定性的な制度
「주의 종목 / 경보 / 이상거래 탐지」bithumb market warnings市場警報システム（경보제） — 市場データに基づく、自動かつ定量的な検知
曖昧なリクエスト（例：「유의 상태」、「위험한 코인」）2つの制度の違いを説明し、どちらを指しているか確認してから、片方だけを呼び出します—

両方の API を自動的に呼び出してはいけません。例外：ユーザーが「둘 다 / 전부（両方／すべて）」を明示的に求めた場合に限ります。

コマンド一覧

#コマンド説明
1bithumb market markets取引可能なすべてのペアを一覧表示します（KRW 市場と BTC 市場）
2bithumb market ticker <markets>現在の価格ティッカー：最終価格、24時間の高値／安値／出来高／変動
3bithumb market orderbook <markets>1つ以上の市場の注文板（買い注文／売り注文）
4bithumb market trades <market>最近の公開取引履歴
5bithumb market candles-minutes <market>分足ローソク足（1／3／5／10／15／30／60／240分）
6bithumb market candles-days <market>日足ローソク足
7bithumb market candles-weeks <market>週足ローソク足
8bithumb market candles-months <market>月足ローソク足
9bithumb market warnings市場警報システム（경보제）— 自動的な異常検知（주의 종목）
10bithumb market notices取引所のお知らせ／告知一覧
11bithumb market fee-inout <currency>通貨ごとの入出金手数料情報

操作フロー

ステップ 1 — データの種類を特定し、参照資料を読み込みます

ユーザーの意図読み込む参照資料
価格、ローソク足、注文板、最近の取引{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）。
  • ローソク足の単位：分足でサポートされているのは1, 3, 5, 10, 15, 30, 60, 240のみです。
  • ローソク足の件数：最小1、最大200、デフォルトは1です。
  • ローソク足の--to：KSTのタイムゾーン情報を含まない日時YYYY-MM-DDTHH:MM:SSを指定します。この時刻より前のローソク足を返します。タイムゾーンオフセット（+09:00、Z、+0900など）は含めないでください。オフセット付きの値はBithumbにHTTP 400 Invalid parameterで拒否されます。 2026-01-01T00:00:00 ✓ / ...+09:00 ✗ / ...Z ✗
  • 取引履歴の--to（ローソク足とは異なります）：時刻のみを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の2つです。現物のみで、デリバティブには対応していません。
  • ローソク足データは時刻順に並んでいます。
  • --jsonを指定すると、Bithumb APIの生のレスポンスを返します（任意のコマンドに追加できます）。

コメント

Markdown 対応