BitCLI

---

💡 AI 交易的经济学：原始 API 为何会消耗资金

大多数 AI 交易 Agent 使用标准 REST 端点（CCXT、Binance FAPI 或 Bybit V5）连接加密货币交易所。这会在原始格式样板上浪费大量上下文令牌。

交易所返回的标准 100 根 K 线 JSON 数组包含 13 位 Unix 时间戳、报价/基础货币成交量字符串和交易笔数。Agent 的大模型上下文窗口会被未经解析的字符串塞满，同时还必须在自己的上下文中计算 RSI、EMA 和 MACD，既浪费令牌，也容易产生数学幻觉。

令牌基准测试（100 根 K 线，5 分钟时间周期）

数据提供方 / 格式	载荷策略	令牌数（100 根）	推理成本（10k 次调用）*	上下文效率
Bybit V5 REST API	带命名键值对的 JSON 对象	~3,450	$86.25	基准（臃肿）
CCXT Library（Python）	原始 6 元素 JSON 数组	~2,680	$67.00	行业平均水平
BitCLI BCT-30 Matrix	按千美元缩放 + 服务端指标	~790	$19.75	🔥 令牌减少 70%

*价格基于标准 OpenAI GPT-4o / Claude 3.5 Sonnet 输入令牌定价（每 1M 个令牌 $2.50）。

💰 核心结论

BitCLI 查询费用为 $0.001 USD（按需付费）。
每次调用减少 ~1,900 个令牌，BitCLI 在每次请求中都能节省约 $0.0048 的模型推理费用。
只需花费微不足道的零头获取精选市场数据，即可节省大笔大模型计算费用。

---

⚡ BCT-30 蜡烛图矩阵

BitCLI 不会返回原始交易所 JSON，而是返回密集的数学格式 **BCT-30（BitCLI Compact Candlesticks，BitCLI 紧凑型蜡烛图）**矩阵：

@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）均以千美元（kUSD）为单位。
• 杜绝数学幻觉： RSI、EMA、ATR、MACD 和布林带均由服务端使用 C++ 计算，并预热 3,000 根历史 K 线。Agent 读取的是原始机构级真实数据。

---

📡 双重集成架构

1. 无状态助手（Cursor、Claude Desktop、ChatGPT）

• 端点： POST https://mcp.bitcli.io/mcp
• 模式： Agent 根据提示词查询市场数据或执行风险计算。
• 异步告警： 通过 alert_manager 设置触发器后，Agent 无需保持连接打开，也无需轮询。触发器会注入 C++ 内存核心。触发条件达成时，BitCLI 会立即向用户的 Telegram 或 Discord 频道推送通知。

2. 自主交易 Agent（Python SDK）

• 端点： wss://mcp.bitcli.io/stream
• 模式： 全双工事件流，支持自动重连和 Replay API。Agent 在内存中休眠，并通过亚毫秒级 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 余额、每日配额使用情况，并列出已验证的 Telegram / Discord 目标 ID。

---

🚀 快速开始：连接你的 AI 客户端

1. 生成 API 密钥

通过 Discord、Telegram 或 Web3 登录网页控制面板，或在 @bitclibot 中使用 /profile 生成开发者密钥：

bcli_your_api_key_here

2. Cursor IDE 集成

将 BitCLI 添加到项目的 .cursor/mcp.json 中：

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

3. Claude Desktop 配置

将 BitCLI 添加到你的 claude_desktop_config.json 中：

{
  "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 工具严格执行所有权验证——Agent 只能向你的账户明确验证过的目标 ID 发送消息。
• 零轮询开销： 无需在 cron 循环中消耗 Token。通过 alert_manager 设置触发器，让我们的基础设施向你的频道发送通知。

📄 许可证

此 MCP 规范和客户端封装采用 MIT License 开源。