polymarket-mcp

面向 AI 智能体的预测市场情报。 为 Polymarket 提供钱包评分、套利检测、流动性分析和实时价格馈送——由来自 195 个以上精选链上钱包的专有数据支持。

它能做什么？

询问你的 AI 智能体：

• “找出所有 YES + NO 价格之和不等于 100% 的 Polymarket 市场”

• “如果我在比特币 10 万美元的市场买入 500 美元的 YES，滑点是多少？”

• “按评分和盈亏 (PnL) 向我展示 Polymarket 上排名前 20 的钱包”

• “哪些钱包与这个巨鲸进行共同交易？找出影子网络。”

• “这个市场的流动性等级是多少——进入是否安全？”

• “计算我在这 5 个头寸上的投资组合风险”

• “比特币在 6 月份达到 15 万美元的概率是多少？”

• “扫描今日加密货币新闻并匹配到开放的 Polymarket 市场”

安装

pip install polymarket-trading-mcp

或者直接运行：

uvx --python 3.11 polymarket-trading-mcp

MCP 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "polymarket": {
      "command": "polymarket-mcp",
      "args": ["--stdio"]
    }
  }
}

作为 SSE 服务器运行：

polymarket-mcp
# Starts on http://127.0.0.1:8000/sse

作为可流式传输的 HTTP 运行：

polymarket-mcp --http
# Starts on http://127.0.0.1:8000/mcp

然后将你的客户端指向 http://127.0.0.1:8000/sse 或 http://127.0.0.1:8000/mcp。

比较

工具

免费工具

遍历 CLOB 订单簿并计算给定头寸规模的平均成交价格。

estimate_slippage(
    market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328",
    side="BUY",
    position_size_usd=500.0
)

返回：best_price（最优价格）、avg_fill_price（平均成交价）、slippage_pct（滑点百分比）、liquidity_available（可用流动性）、recommendation（建议：go/caution/no-go）。

扫描市场的流动性深度，包括距离中间价 1%/2%/5% 处的价差和深度。

scan_market_liquidity(market_id="71321045679252212594626385532587807886473352341859285086426388424842616389328")

返回：best_bid（最优买单）、best_ask（最优卖单）、spread_pct（价差百分比）、深度桶、liquidity_grade（流动性等级 A/B/C）。

扫描所有活跃的 Polymarket 市场，寻找 YES + NO 价格之和不等于 1.00 的情况。

find_arbitrage_gaps(min_gap_pct=2.0)

返回：存在缺口的市场、缺口大小以及利用方向（BUY_BOTH 或 SELL_BOTH）。

并行获取来自币安和/或 CoinGecko 的实时加密货币价格，并附带延迟元数据。

get_crypto_price(symbol="BTC", sources="binance,coingecko")

返回：各来源价格、平均值、来源间的最大偏差。

活跃 Polymarket 合约的剩余时间和结算状态。BTC 5 分钟/15 分钟合约使用 slug 时间戳解析以获取精确到期时间。

get_contract_status(market_id="btc-updown-5m-1711234567")
get_contract_status(category="crypto")  # scan all short-duration contracts

返回：time_remaining_seconds（剩余秒数）、time_remaining_human（人类可读剩余时间）、current_odds（当前赔率）。

使用结构化推理估算任何事件的概率。基准率、关键因素、时间框架分析——全部包含在一个结构化的 JSON 响应中。

estimate_probability(question="Will Bitcoin reach $150k before end of 2025?")

返回：estimated_probability（0-1）、confidence_level（置信度）、factors_for（支持因素）、factors_against（反对因素）、base_rate_note（基准率说明）、reasoning（推理过程）。

针对预测市场头寸组合的纯数学风险指标。无外部 API 调用。

calculate_portfolio_risk(positions='[{"market_id": "abc123", "side": "YES", "size": 200, "entry_price": 0.65}]')

返回：total_exposure（总敞口）、max_loss（最大损失）、max_gain（最大收益）、diversification_score（多元化评分）、kelly_warnings（凯利警告）、rebalancing_suggestions（再平衡建议）。

返回评分方法、当前数据集统计和定价。先调用此接口以评估付费数据是否值得购买。无需 API 密钥。

付费工具（需要 API 密钥）

注册即享 7 天免费试用。试用期后：在 Polygon 上按 USDC 每次请求付费。批量折扣：每天超过 1000 次请求可享 5 折优惠。

查找在相同 Polymarket 类别中与种子钱包共同交易的钱包。

get_shadow_wallets(seed_wallet="0xabc...", api_key="your-key")

返回：最多 20 个按共同交易强度、共享类别、胜率排名的影子钱包。

来自 MoonMirror 评分引擎的顶级 Polymarket 钱包（盈亏 + 一致性 + 专业化 - 回撤惩罚）。

get_top_wallets(api_key="your-key", limit=50, min_score=0.5)

特定钱包地址的完整评分细分。

get_wallet_score(address="0xabc...", api_key="your-key")

返回：评分组件、胜率、交易次数、数据新鲜度。

钱包的已实现盈亏，包含各类别细分。由 Goldsky 子图预先计算得出。

get_wallet_pnl(address="0xabc...", api_key="your-key")

独立出现在 3 个以上不同高分钱包旁边的钱包——比单一影子匹配信号更强。

get_wallet_clusters(api_key="your-key", min_co_trades=3)

活跃的 BTC 5 分钟和 15 分钟 Polymarket 合约，包含代币 ID 和当前中间价。已缓存，每 60 秒刷新一次。

get_btc_short_markets(api_key="your-key")

使用 Claude 的推理能力对预测市场问题进行结构化概率分析。

analyze_market_sentiment(question="Will Ethereum ETF hit $10B AUM by Q3 2025?", api_key="your-key")

定价

也可提供独立包：polymarket-slippage, polymarket-liquidity, polymarket-arb-detector, polymarket-price-feed, polymarket-sentiment, polymarket-timer, polymarket-news, polymarket-onchain

为什么选择此服务器？

其他所有 Polymarket MCP 服务器都查询公共 API。我们拥有专有的钱包情报——精选评分、来自 Goldsky 的真实盈亏数据，以及通过对手方挖掘发现的影子钱包网络。这是你在其他任何地方都无法获得的数据。

付费钱包工具由 MoonMirror 提供支持，这是一个 Polymarket 钱包情报引擎。MoonMirror 持续监控链上钱包，根据盈亏、一致性和市场专业化程度对其进行评分，并预先计算影子钱包关系。

所有钱包查询均在 < 100ms 内返回，因为所有内容都是预先计算好的。没有阻塞性的子图调用。

配置

所有设置均通过环境变量进行：

# Server
HOST=127.0.0.1
PORT=8000

# DB paths (for self-hosted wallet intelligence)
MOONMIRROR_DB_PATH=/path/to/moonmirror.db
SERVICES_DB_PATH=/path/to/services.db

# Pricing
PRICE_WALLET_INTEL=0.05
PRICE_MARKET_DATA=0.01
TRIAL_DAYS=7

# Rate limiting
RATE_PER_KEY=5
RATE_GLOBAL=20

# Create an API key
polymarket-mcp --create-key "customer-name"

# Top up a key's USDC balance
polymarket-mcp --top-up YOUR_KEY 10.0

github.com/whitmorelabs/polymarket-mcp — 欢迎提交问题、PR 和点赞。