🚀 PolyMarket 多边形市场预测平台

PolyMarket 是一个基于多边形网络的去中心化预测市场平台，用户能在上面创建和交易与现实世界事件相关的代币。用户可依据对事件结果的信心进行投注，通过代币价格的波动获取收益。

🚀 快速开始

PolyMarket 多边形协议（MCP）服务器是连接到 PolyMarket API 的代理服务器，为用户提供预测市场的数据接口。

✨ 主要特性

灵活性

MCP 服务器支持多种接口调用方式，用户可按需选择合适的调用方法。

高效性

通过优化 API 调用流程和采用高效的缓存机制，保障数据查询的速度和响应时间。

可扩展性

系统架构设计灵活，能根据业务需求进行横向扩展，满足高并发场景下的性能要求。

📦 安装指南

安装步骤

1. 前提条件

   • 确保已安装 Python 3.9 或更高版本。
   • 验证 httpx 库是否已安装，若未安装可使用以下命令进行安装：

     pip install httpx>=0.24.0
     

   • 安装 mcp-core 和 python-dotenv：

     pip install mcp-core python-dotenv>=1.0.0
     

2. 代码示例 初始化 MCP 代理服务器的步骤如下：

from mcp_core import MP

# 初始化代理
mp = MP()

# 连接 PolyMarket 网络
await mp.connect()

# 获取当前所有市场信息
markets = await mp.list_markets()

本地运行指南

# 克隆 MCP 项目仓库
git clone https://github.com/poly_market/mcp.git

# 进入项目目录
cd mcp

# 安装依赖项
pip install -r requirements.txt

# 启动服务器
python3 server.py

💻 使用示例

基础用法

from mcp_core import MP

# 初始化代理
mp = MP()

# 连接 PolyMarket 网络
await mp.connect()

# 获取当前所有市场信息
markets = await mp.list_markets()

📚 详细文档

数据接口文档

获取市场列表

• 功能描述：获取当前 PolyMarket 平台上的所有可用市场信息。
• 输入参数：无，无需提供任何参数。
• 返回值：返回 JSON 格式的数据，包含以下字段：
  • id：市场唯一标识符
  • event_name：事件名称
  • description：事件描述
  • start_time：事件开始时间（ISO 8601 格式）
  • end_time：事件结束时间（ISO 8601 格式）
• 示例响应：

[
    {
        "id": "market_1",
        "event_name": "2024年美国总统选举结果",
        "description": "预测谁将赢得2024年美国大选。",
        "start_time": "2023-01-01T00:00:00Z",
        "end_time": "2024-11-08T23:59:59Z"
    },
    ...
]

获取市场详情

• 功能描述：查询指定市场的详细信息。
• 输入参数：
  • market_id：市场唯一标识符（字符串类型）
• 返回值：返回 JSON 格式的数据，包含以下字段：
  • id：市场唯一标识符
  • event_name：事件名称
  • description：事件描述
  • start_time：事件开始时间（ISO 8601 格式）
  • end_time：事件结束时间（ISO 8601 格式）
  • outcomes：可能的事件结果及其对应的价格信息
• 示例响应：

{
    "id": "market_1",
    "event_name": "2024年美国总统选举结果",
    "description": "预测谁将赢得2024年美国大选。",
    "start_time": "2023-01-01T00:00:00Z",
    "end_time": "2024-11-08T23:59:59Z",
    "outcomes": [
        {
            "outcome_id": "outcome_1",
            "label": "乔·拜登胜选",
            "probability": 0.7,
            "price": 0.65
        },
        {
            "outcome_id": "outcome_2",
            "label": "唐纳德·特朗普胜选",
            "probability": 0.3,
            "price": 0.45
        }
    ]
}

获取市场历史数据

• 功能描述：查询指定时间段内的市场历史数据。
• 输入参数：
  • market_id：市场唯一标识符（字符串类型）
  • start_time：数据起始时间（ISO 8601 格式，可选，默认为最早记录时间）
  • end_time：数据结束时间（ISO 8601 格式，可选，默认为当前时间）
• 返回值：返回 JSON 格式的数据列表，每一项包含以下字段：
  • timestamp：时间戳
  • price：当时市场价格
  • volume：当时交易量
• 示例响应：

[
    {
        "timestamp": "2023-10-01T00:00:00Z",
        "price": 0.65,
        "volume": 1234.56
    },
    ...
]

错误处理

错误代码

错误响应示例

{
    "error": {
        "code": 400,
        "message": "参数 market_id 缺失或无效"
    }
}

文档扩展

如需更多详细信息，请参考官方文档。

🤝 贡献指南

欢迎社区开发者参与项目开发，贡献代码或提出建议。请访问GitHub 仓库了解更多信息。

⚠️ 重要提示

使用本 API 前，请仔细阅读并遵守 PolyMarket 的服务条款和使用规范，确保合规合法地进行相关操作。