BitCLI

---

💡 AI 取引の経済性：生の API で資金が流出する理由

ほとんどの AI 取引エージェントは、標準的な REST エンドポイント（CCXT、Binance FAPI、Bybit V5）を使って暗号資産取引所に接続します。これにより、生のフォーマットに関する定型情報に膨大なトークンコンテキストが消費されます。

取引所からの標準的な 100 本のローソク足の JSON 配列には、13 桁の Unix タイムスタンプ、クオート／ベースの出来高文字列、取引件数が含まれます。エージェントの LLM コンテキストウィンドウは解析されていない文字列で埋まり、さらに自身のコンテキスト内で RSI、EMA、MACD を計算しなければならないため、トークンを浪費し、計算を幻覚します。

トークンベンチマーク（100 本、時間足 5 分）

データプロバイダー／形式	ペイロード戦略	トークン数（100 本）	推論コスト（1 万回の呼び出し）*	コンテキスト効率
Bybit V5 REST API	名前付き JSON キーと値のオブジェクト	約 3,450	$86.25	ベースライン（肥大化）
CCXT Library (Python)	生の 6 要素 JSON 配列	約 2,680	$67.00	業界平均
BitCLI BCT-30 Matrix	千単位にスケールした USD ＋サーバー側インジケーター	約 790	$19.75	🔥 トークンを 70% 削減

*料金は標準的な OpenAI GPT-4o／Claude 3.5 Sonnet の入力トークン料金（100 万トークンあたり $2.50）に基づいています。

💰 要点

BitCLI のクエリ料金は 0.001 USD（従量課金制）です。
1 回の呼び出しあたり約 1,900 トークン削減することで、BitCLI は毎回のリクエストでモデル推論料金を約 $0.0048 節約します。
厳選された市場データには微額を支払い、LLM の計算コストを大幅に節約できます。

---

⚡ BCT-30 ローソク足マトリックス

BitCLI は取引所の生の JSON の代わりに、密度の高い数学的な BCT-30（BitCLI Compact Candlesticks） マトリックスを返します。

@BCT: BYBIT:BTCUSDT|5m|1719705600|kUSD
@META: OI:$1.54B(+0.05%|+0.21%|-2.14%) | Fund_8h:+0.0100% | RVOL:2.4x | RSI:62.14 | EMA200:64,250.00
@FIELDS: idx o h l c v dv rsi:14 ema:200
-4 64120.5 64180.0 64100.0 64150.0 1250 +420 58.2 64210.0
-3 64150.0 64210.0 64140.0 64195.0 2100 +1150 61.4 64225.0
-2 64195.0 64230.0 64180.0 64210.0 1800 +350 62.1 64238.0
-1 64210.0 64260.0 64190.0 64245.0 3400 +2100 64.8 64248.0
 0 64245.0 64280.0 64220.0 64270.0 1450 +680 66.2 64250.0

• ゼロトークンの時間グリッド： 各行に 13 桁の Unix タイムスタンプを含めません。相対整数デルタインデックス（-N ... 0）により、@BCT の基準タイムスタンプから正確な時間を決定論的に再構成します。
• 正規化された指標： 出来高（v）と累積出来高デルタ（dv）は、千 USD（kUSD）単位に変換されます。
• 計算の幻覚ゼロ： RSI、EMA、ATR、MACD、ボリンジャーバンドは、3,000 本分の過去データによるウォームアップを行い、サーバー上の C++ で計算されます。エージェントは機関投資家水準の正確なデータを読み取ります。

---

📡 デュアル統合アーキテクチャ

1. ステートレスアシスタント（Cursor、Claude Desktop、ChatGPT）

• エンドポイント： POST https://mcp.bitcli.io/mcp
• モード： エージェントは、プロンプトに応じて市場データをクエリするか、リスク計算を実行します。
• 非同期アラート： alert_manager を使ってトリガーを設定する際、エージェントが接続を開いたままにしたり、ポーリングしたりする必要はありません。トリガーは C++ メモリーコアに注入されます。条件に達すると、BitCLI はユーザーの Telegram または Discord チャンネルに即座にプッシュ通知を送信します。

2. 自律型取引エージェント（Python SDK）

• エンドポイント： wss://mcp.bitcli.io/stream
• モード： 自動再接続と Replay API を備えた全二重イベントストリームです。エージェントはメモリー内で休止し、サブミリ秒の WebSocket フレームプッシュによって起動します。

---

🛠️ 6つのコア MCP ツール

ツール	アクション	料金	説明
system_docs	read	無料（$0.00）	RAG を通じて、BitCLI の公式ドキュメント、コマンド文法、インジケーターの計算式にアクセスします。
market_data	read	$0.001	BCT-30 のローソク足マトリックス、取引所横断の定量テクニカル分析（TA）のコンセンサス、1,650 以上のコントラクトを対象とした動的スクリーニングを利用できます。
calc_engine	compute	$0.001	数学的なリスクモデル：ドル建てのリスクに基づくロットサイズ計算（/pos）、MMR を用いた実際の清算価格（/liq）、DCA の損益分岐点、複数ターゲットのリスクリワード比。
alert_manager	write	$0.001～$0.002	サブ 500ns のトリガーを C++ の RAM に注入します。トリガーに達すると Telegram／Discord に通知を送信します。
send_notification	write	$0.001	AI がユーザーの Telegram チャット／チャンネル、または Discord Webhook に HTML メッセージを直接送信します。
user_account	read	無料（$0.00）	USD 残高、1 日あたりのクォータ使用量を確認し、確認済みの Telegram／Discord 宛先 ID の一覧を取得します。

---

🚀 クイックスタート：AI クライアントの接続

1. API キーを生成する

Web ダッシュボード（Discord、Telegram、または Web3 経由）にログインするか、@bitclibot で /profile を使用して、開発者キーを生成します：

bcli_your_api_key_here

2. Cursor IDE との連携

プロジェクトの .cursor/mcp.json に BitCLI を追加します：

{
  "mcpServers": {
    "bitcli": {
      "url": "https://mcp.bitcli.io/mcp",
      "headers": {
        "Authorization": "Bearer bcli_your_api_key_here"
      }
    }
  }
}

3. Claude Desktop の設定

claude_desktop_config.json に BitCLI を追加します：

{
  "mcpServers": {
    "bitcli": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bitcli.io/mcp",
        "--header",
        "Authorization: Bearer bcli_your_api_key_here"
      ]
    }
  }
}

---

⌨️ 統一コマンド構文（チャットと alert_manager で使用）

Telegram に入力する場合も、MCP の command パラメーターに渡す場合も、まったく同じ構文を使用できます：

• 正確な価格： btc 95k または binance eth 3150
• 変動速度（急激な値動き）： sol +3.5% 5m（5 分間で 3.5% を超える急騰）
• 大口取引の出来高急増： * vol 15m x4（全体をスキャン：20-SMA を 4 倍上回る）
• 清算の連鎖： * liq z3（清算が標準偏差の 3 倍を超える）
• 注文フロー（CVD）： btc cvd div 15m（累積出来高デルタのダイバージェンス）
• リスクに基づくポジションサイズ計算： /pos btc 65k 63.7k 50（固定リスク $50 の計算）

---

🛡 セキュリティと透明性

• 取引所の API キーは不要： BitCLI は資金を預からず、取引所の秘密取引キーを要求しません。
• 分離されたルーティング： send_notification ツールは所有権の検証を厳格に適用します。エージェントがメッセージを送信できるのは、アカウントで明示的に確認された宛先 ID のみです。
• ポーリングのオーバーヘッドはゼロ： cron ループでトークンを消費する必要はありません。alert_manager でトリガーを設定すれば、インフラストラクチャがチャンネルに通知します。

📄 ライセンス

この MCP 仕様とクライアントラッパーは、MIT License に基づくオープンソースです。