Skip to main content
可作为 MCP 工具调用：polymarket_market_read + polymarket_price_history —— 可在 Claude / Cursor / 任意 MCP 客户端中直接使用。详见 MCP Server 60 秒配置。
已上线   免费 · market read   免费 · price history

​
它为 Agent 做什么

polymarket_market_read 用来读取从预测市场 event card 里选中的单个 market。它返回 market 问题、状态、outcomes、outcome token ids、标签、流动性、成交量和所属 event 信息，帮助 agent 判断下一步应该看哪个 outcome。 polymarket_price_history 接收这个 market 里的一个 outcome_token_id，返回 1h 或 1d 粒度的隐含概率点。用它展示市场概率如何随时间变化；不要把它当成 OHLCV K 线、订单簿深度或可成交报价。

​
Agent flow

​
返回值

​
Market read 返回

​
data
PolymarketMarket
required
单张 market card。
​
meta.creditsUsed
number
Market read 固定为 0。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · market read
{
  "data": {
    "market_card_id": "e370488a-33b5-4abd-8c5c-37c7ad8a60fc",
    "event_card_id": "4b8f35c6-4781-4f3c-9237-142fc16467cd",
    "market_question": "Bitcoin ETF approved by Jan 15?",
    "outcomes": [
      {
        "label": "Yes",
        "outcome_token_id": "98787006152320761811798607481686168525551752574583108841982899511109091268658",
        "current_probability": 0.51,
        "last_price_time": "2024-01-10T00:00:00Z",
        "coverage_status": "partial"
      },
      { "label": "No", "outcome_token_id": null, "current_probability": 0.49 }
    ],
    "status": "closed",
    "volume": 1250000,
    "liquidity": 48000,
    "coverage_status": "partial"
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 99 }
}

​
Price history 返回

​
data
PolymarketPriceHistory
required
单个 outcome token 的概率历史。
​
meta.count
number
返回的数据点数量。
​
meta.creditsUsed
number
Price history 固定为 0。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · price history
{
  "data": {
    "outcome_token_id": "98787006152320761811798607481686168525551752574583108841982899511109091268658",
    "interval": "1d",
    "points": [
      { "time": "2024-01-01T00:00:00Z", "probability": 0.39, "price": 0.39 },
      { "time": "2024-01-02T00:00:00Z", "probability": 0.42, "price": 0.42 }
    ],
    "coverage_status": "partial",
    "coverage_notice": "Partial probability history is available for the requested window."
  },
  "meta": { "count": 2, "creditsUsed": 0, "remainingCredits": 99 }
}

​
说明

从 预测市场事件 开始。Market id 和 outcome token id 都应该从 event card 里选，不要靠猜。
叙事时间线优先用 1d；如果 agent 需要看某个事件日前后的日内变化，再用 1h。
interval 只接受 1h 和 1d。interval=15m 这类请求会在扣 credit 前返回 400。
Price history 返回的是单个 outcome token 的隐含概率点。它不是 OHLCV、订单簿数据、成交历史或投资建议。

​
直接调用

// 1) 读取 market
{
  "method": "tools/call",
  "params": {
    "name": "polymarket_market_read",
    "arguments": { "market_card_id": "pmm_253254" }
  }
}

// 2) 读取 Yes outcome 的日度概率历史
{
  "method": "tools/call",
  "params": {
    "name": "polymarket_price_history",
    "arguments": {
      "outcome_token_id": "98787006152320761811798607481686168525551752574583108841982899511109091268658",
      "interval": "1d",
      "start_time": "2024-01-01T00:00:00Z",
      "end_time": "2024-01-15T00:00:00Z"
    }
  }
}

​
完整参数参考

​
market_card_id
string
required
Event card 返回的 market id；也接受 alias pmm_253254。
​
outcome_token_id
string
required
polymarket_market_read 返回的 outcome token id。
​
interval
string
required
1h 或 1d。
​
start_time
string
ISO 8601 UTC 起始时间。必须和 end_time 一起使用。
​
end_time
string
ISO 8601 UTC 结束时间。必须和 start_time 一起使用。
​
limit
number
可选的返回 points 上限。范围 1-20000。

​
相关接口

预测市场事件

先浏览、搜索并读取 event card，再选择 market。

预测市场概率历史

选好 outcome token 后，查询它的概率历史。