AI导哈

预测市场API服务器

提供对Polymarket预测市场API的访问，具备完整交易功能的模型上下文协议服务器。

  • by arekgotfryd
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 arekgotfryd/polymarket-mcp

使用说明

Polymarket MCP服务器

MCP（模型上下文协议）服务器，提供对具有完整交易功能的Polymarket预测市场API的访问。

特性

此服务器公开 40+工具 跨Polymarket API：

Gamma API（市场发现和元数据）

  • get_events -获取预测市场事件
  • get_event_by_id -按ID获取事件
  • get_event_by_slug -通过URL slug获取事件
  • get_markets -获取预测市场
  • get_market_by_id -按ID获取市场
  • get_market_by_slug -通过URL slug获取市场
  • get_tags -获取可用的市场标签/类别
  • search_markets -按文本查询搜索市场

CLOB API-公开（价格、订单）

  • get_price -获取代币的当前市场价格
  • get_prices -获取多个代币的价格
  • get_midpoint -获取中点价格
  • get_orderbook -获取代币的订单簿
  • get_spread -获取买卖价差
  • get_last_trade_price -获取最后交易价格
  • get_price_history -获取历史价格数据
  • get_clob_markets -获取所有CLOB市场
  • get_clob_market -按条件ID获取CLOB市场
  • get_tick_size -获取令牌的最小刻度大小
  • get_neg_risk -获取代币的负风险标志

CLOB API-交易（需要身份验证）

  • create_order -创建并提交限价订单
  • create_market_order -创建并提交市价单
  • cancel_order -取消特定订单
  • cancel_orders -取消多个订单
  • cancel_all_orders -取消所有未结订单
  • cancel_market_orders -取消某个市场的所有订单
  • get_open_orders -获取所有未结订单
  • get_order -按ID获取特定订单
  • get_user_trades -获取经过身份验证的用户的交易历史记录

余额和账户

  • get_balance_allowance -获取余额和津贴信息
  • update_balance_allowance -更新/刷新交易额度
  • derive_api_key -从钱包中获取API凭证
  • get_api_keys -获取所有API密钥

奖励和收入

  • get_earnings_for_day -获取一天的收入明细
  • get_reward_percentages -获得流动性奖励等级

API数据（职位、活动和历史记录）

  • get_positions -获取用户位置
  • get_trades -为用户/市场获取交易
  • get_activity -获取用户链上活动
  • get_holders -获得顶级职位
  • get_position_value -获取总位置值
  • get_closed_positions -获取用户的已平仓头寸
  • get_leaderboard -获取交易者排行榜
  • get_open_interest -获取开放兴趣数据
  • get_event_volume -获取事件交易量

效用

  • get_gamma_status -检查Gamma API健康状况
  • get_clob_status -检查CLOB API运行状况
  • get_data_status -检查数据API运行状况
  • get_server_time -获取CLOB服务器时间

安装

npm install
npm run build

配置

环境变量

对于交易功能，请设置以下环境变量：

# Required for trading
POLYMARKET_PRIVATE_KEY=your_wallet_private_key
POLYMARKET_FUNDER_ADDRESS=your_polymarket_profile_address

# Optional (defaults to 0)
POLYMARKET_SIGNATURE_TYPE=0  # 0=EOA wallet, 1=Magic/email login

注： 资助者地址是您存入USDC的Polymarket个人资料地址，而不是您的钱包地址。您可以在Polymarket帐户设置中找到这一点。

用法

使用Claude桌面版

添加到您的Claude Desktop配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/path/to/polymarket-mcp-server/dist/index.js"],
      "env": {
        "POLYMARKET_PRIVATE_KEY": "your_private_key",
        "POLYMARKET_FUNDER_ADDRESS": "your_funder_address"
      }
    }
  }
}

只读模式（无交易）

如果不提供环境变量，服务器仍将适用于所有只读操作（市场数据、价格、订单簿等）。如果调用交易工具，将返回错误。

发展

npm run dev

API基本URL

  • API伽马: https://gamma-api.polymarket.com
  • API法规: https://clob.polymarket.com
  • 数据API: https://data-api.polymarket.com

查询示例

只读操作

获取活跃的政治事件：

get_events(tag_id: "politics", closed: false, limit: 10)

获取市场的当前价格：

get_price(token_id: "...", side: "BUY")

获取顶级交易员：

get_leaderboard(period: "weekly", limit: 10)

交易操作（需要身份验证）

下达限价订单，以0.45美元的价格买入：

create_order(token_id: "...", price: 0.45, size: 10, side: "BUY")

下达市价订单：

create_market_order(token_id: "...", amount: 50, side: "BUY")

查看您的未结订单：

get_open_orders()

取消所有订单：

cancel_all_orders()

检查USDC余额：

get_balance_allowance(asset_type: "USDC")

资源

许可证

麻省理工学院

相关 MCP