PolyMarket接口

你是否曾经希望AI能够实时获取预测市场的价格、概率和历史数据，帮你分析市场趋势？今天要介绍的开源项目PolyMarket接口，正是为了实现这个目标而设计的。它通过MCP协议提供了与PolyMarket API的交互能力，让AI能够获取预测市场数据，例如市场信息、价格和历史数据。

项目基本信息

一、项目介绍

PolyMarket接口是一个MCP服务器，让AI能够通过标准化协议访问PolyMarket预测市场的API。它提供了四个核心工具，涵盖市场信息查询、价格获取和历史数据分析。

这个服务器提供了以下工具：

• get-market-info：获取特定预测市场的详细信息
• list-markets：列出可用的预测市场并提供过滤选项
• get-market-prices：获取当前价格和交易信息
• get-market-history：获取历史价格和交易量数据

二、核心优势

数据全面

提供预测市场的完整数据：

• 市场信息（标题、类别、状态、结算日期）
• 当前价格和概率
• 历史价格和交易量

灵活过滤

支持按状态（开放/关闭/已结算）过滤市场列表。

多时间段支持

历史数据支持1天、7天、30天和全部时间段。

错误处理完善

内置针对各种场景的错误处理：

• 速率限制（429错误）
• 无效API密钥（403错误）
• 无效市场ID（404错误）
• 网络连接问题
• API超时（30秒）

三、适用场景

预测市场分析

让AI获取预测市场的价格和概率，分析市场趋势。

数据可视化

AI可以获取历史数据，生成价格走势图表。

投资决策辅助

AI可以根据市场数据提供投资建议。

市场监控

AI可以定期获取市场状态和价格变化。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并安装依赖

git clone https://github.com/berlinbra/polymarket-mcp.git
cd polymarket-mcp
uv pip install -e .

第二步：配置环境变量

创建.env文件：

Key=your_api_key_here
Funder=your_polymarket_wallet_address

第三步：配置Claude Desktop

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "polymarket-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/polymarket-mcp",
        "run",
        "src/polymarket_mcp/server.py"
      ],
      "env": {
        "KEY": "your_api_key",
        "FUNDER": "your_wallet_address"
      }
    }
  }
}

第四步：通过Smithery安装（可选）

npx -y @smithery/cli install polymarket_mcp --client claude

第五步：重启Claude Desktop

保存配置后，重启Claude Desktop。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来查询PolyMarket数据了。

示例1：获取市场信息

用户指令：“获取市场ID为‘pres-election-2024’的详细信息”

AI会调用get-market-info工具：

{
  "market_id": "pres-election-2024"
}

示例2：列出市场

用户指令：“列出所有开放状态的预测市场，限制10个”

AI会调用list-markets工具：

{
  "status": "open",
  "limit": 10
}

示例3：获取当前价格

用户指令：“获取市场‘pres-election-2024’的当前价格”

AI会调用get-market-prices工具：

{
  "market_id": "pres-election-2024"
}

示例4：获取历史数据

用户指令：“获取市场‘pres-election-2024’过去7天的历史价格”

AI会调用get-market-history工具：

{
  "market_id": "pres-election-2024",
  "timeframe": "7d"
}

示例5：分页获取市场

用户指令：“从第20个开始，列出10个市场”

{
  "limit": 10,
  "offset": 20
}

六、常见问题

问题1：提示“Invalid API key”

解决方案：确认PolyMarket API密钥正确，检查.env文件中的Key值。

问题2：速率限制错误

解决方案：减少请求频率，服务器内置了速率限制管理。

问题3：市场ID格式

解决方案：市场ID可以是数字ID或字符串slug，如“pres-election-2024”。

问题4：Python版本要求

解决方案：需要Python 3.9或更高版本。

问题5：历史数据时间范围

解决方案：支持1d、7d、30d、all四种时间段。

七、总结

PolyMarket接口是一个专注于预测市场数据的MCP服务器，让AI能够轻松获取PolyMarket的市场信息、价格和历史数据。

这个项目的最大价值在于：

1. 数据完整：提供市场信息、价格、历史数据
2. 灵活过滤：支持按状态筛选市场
3. 多时间段：历史数据支持多种时间范围
4. 错误处理完善：内置速率限制和错误管理
5. 易于集成：通过MCP协议与AI客户端无缝集成

如果你需要分析预测市场数据，或者希望让AI帮助你监控市场变化，PolyMarket接口是一个非常实用的工具。