目录

QuantMCP 开发文档

QuantMCP 提供统一的金融数据API接口，支持多种数据源和MCP协议集成。 本文档将详细介绍如何使用我们的API获取股票、期货、外汇等金融数据。

基础URL

https://api.quantmcp.com/v1

认证

所有API请求都需要在Header中包含API密钥：

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.quantmcp.com/v1/stock/daily

请妥善保管您的API密钥，不要在客户端代码中暴露。

数据源

Tushare 数据接口

获取A股市场数据，包括日线、分钟线、财务数据等。

GET /data/tushare/daily

获取A股日线行情数据

请求参数

参数名 类型 必需 说明
ts_code string 否 股票代码（如：000001.SZ）
trade_date string 否 交易日期（YYYYMMDD格式）
start_date string 否 开始日期
end_date string 否 结束日期

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "items": [
      {
        "ts_code": "000001.SZ",
        "trade_date": "20241201",
        "open": 10.50,
        "high": 10.80,
        "low": 10.30,
        "close": 10.65,
        "pre_close": 10.45,
        "change": 0.20,
        "pct_chg": 1.91,
        "vol": 125678900,
        "amount": 1340567890.5
      }
    ],
    "total": 1
  }
}

Finhub 国际市场数据

获取美股、欧股等国际市场数据。

GET /data/finhub/quote

获取实时股票报价

请求参数

参数名 类型 必需 说明
symbol string 是 股票代码（如：AAPL, TSLA）

自研舆情数据

获取社交媒体情感分析、新闻情感分析等另类数据。

POST /data/sentiment/analysis

获取股票舆情分析数据

MCP协议集成

QuantMCP完全支持Model Context Protocol，可以直接与Claude、GPT等大语言模型集成。

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_stock_data",
    "arguments": {
      "symbol": "AAPL",
      "period": "1d",
      "interval": "1m"
    }
  },
  "id": 1
}

使用示例

Python示例

import requests

# 配置API密钥
API_KEY = "your_api_key_here"
BASE_URL = "https://api.quantmcp.com/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 获取股票日线数据
def get_stock_daily(ts_code, start_date, end_date):
    url = f"{BASE_URL}/data/tushare/daily"
    params = {
        "ts_code": ts_code,
        "start_date": start_date,
        "end_date": end_date
    }
    
    response = requests.get(url, headers=headers, params=params)
    return response.json()

# 使用示例
data = get_stock_daily("000001.SZ", "20241101", "20241201")
print(data)

JavaScript示例

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://api.quantmcp.com/v1';

async function getStockData(symbol) {
    const response = await fetch(`${BASE_URL}/data/finhub/quote?symbol=${symbol}`, {
        headers: {
            'Authorization': `Bearer ${API_KEY}`,
            'Content-Type': 'application/json'
        }
    });
    
    const data = await response.json();
    return data;
}

// 使用示例
getStockData('AAPL').then(data => {
    console.log(data);
});

错误处理

API使用标准HTTP状态码，所有响应都包含统一的错误格式：

{
  "code": 400,
  "msg": "Invalid parameter: ts_code is required",
  "data": null
}

常见错误码

状态码 说明
200 请求成功
400 请求参数错误
401 API密钥无效或缺失
429 请求频率超限
500 服务器内部错误