概览行情数据分析引擎 MCP接入代码示例

API 文档

蜂巢智投-AI期货期权投研提供 REST API 和 MCP 两种接入方式，以下为完整接口说明。

Base URL:

http://localhost:8766

📊 行情数据

GET /api/v2/market/overview

获取全市场行情概览，包含所有品种实时数据、统计数据

// 响应示例
{
  "ok": true,
  "data": [
    {
      "code": "CU",
      "name": "沪铜",
      "type": "商品期货",
      "price": 79500,
      "change_pct": -1.23,
      "signals": {
        "daily_buy2": false,
        "daily_sell2": true
      }
    }
  ],
  "stats": {
    "total": 16,
    "up": 8,
    "down": 8,
    "daily_buy2": 3,
    "daily_sell2": 5
  }
}

GET /api/v2/quote/{symbol}

获取单个品种实时行情

curl http://localhost:8766/api/v2/quote/CU

GET /api/v2/kline/{symbol}?period=day&limit=30

获取K线数据

// 参数说明
period: day | week | month
limit: 1-200

curl "http://localhost:8766/api/v2/kline/CU?period=day&limit=20"

GET /api/v2/symbols?type=futures|etf

获取品种列表

GET /api/v2/search?q={keyword}

搜索品种

🧠 分析引擎

GET /api/v2/analysis/{symbol}

获取品种全面分析（因子评分 + 波动率 + 信号）

curl http://localhost:8766/api/v2/analysis/CU

// 响应示例
{
  "ok": true,
  "symbol": "CU",
  "factor_analysis": {
    "total_score": 0.35,
    "direction": "偏多",
    "confidence": "中",
    "factors": {
      "momentum": { "score": 0.45, "name": "动量" },
      "volatility": { "score": -0.12, "name": "波动率" }
    }
  },
  "volatility": {
    "iv_percentile": 35,
    "status": "低位",
    "signal": "中性"
  },
  "signals": {
    "daily_buy2": false,
    "daily_sell2": true
  }
}

🤖 MCP 接入

MCP (Model Context Protocol) 支持直接对接 Hermes Agent、Claude Code、Cursor 等 AI 工具。

Hermes Agent 配置：

# ~/.hermes/config.yaml 中添加：
mcpServers:
  zhongyan-lite:
    type: http
    url: http://localhost:8766/mcp/sse

Claude Code 配置：

# claude.json
{
  "mcpServers": {
    "zhongyan-lite": {
      "type": "http",
      "url": "http://localhost:8766/mcp/sse"
    }
  }
}

💻 代码示例

Python

import requests

BASE = "http://localhost:8766"

# 获取全市场行情
overview = requests.get(f"{BASE}/api/v2/market/overview").json()
print(f"共 {overview['stats']['total']} 个品种")

# 搜索品种
results = requests.get(f"{BASE}/api/v2/search?q=铜").json()
for item in results['data']:
    print(f"{item['code']}: {item['name']}")

# 分析品种
analysis = requests.get(f"{BASE}/api/v2/analysis/CU").json()
print(f"评分: {analysis['factor_analysis']['total_score']}")
print(f"方向: {analysis['factor_analysis']['direction']}")

JavaScript

const BASE = 'http://localhost:8766';

// 获取全市场行情
const overview = await fetch(`${BASE}/api/v2/market/overview`).then(r => r.json());
console.log(`共 ${overview.stats.total} 个品种，${overview.stats.up} 涨 ${overview.stats.down} 跌`);

// 分析品种
const analysis = await fetch(`${BASE}/api/v2/analysis/CU`).then(r => r.json());
console.log(`沪铜评分: ${analysis.factor_analysis.total_score}`);

// 每30秒刷新
setInterval(async () => {
  const data = await fetch(`${BASE}/api/v2/market/overview`).then(r => r.json());
  updateDashboard(data);
}, 30000);

cURL

# 行情概览
curl -s http://localhost:8766/api/v2/market/overview | jq '.stats'

# 搜索
curl -s "http://localhost:8766/api/v2/search?q=黄金" | jq '.data'

# K线
curl -s "http://localhost:8766/api/v2/kline/CU?limit=5" | jq '.data[:2]'

# 分析
curl -s http://localhost:8766/api/v2/analysis/RB | jq '.factor_analysis.direction'