Polymarket MCP

🚀 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 的服務條款和使用規範，確保合規合法地進行相關操作。