Skip to main content
可作为 MCP 工具调用：polymarket_event_browse + polymarket_event_search + polymarket_event_read —— 可在 Claude / Cursor / 任意 MCP 客户端中直接使用。详见 MCP Server 60 秒配置。
已上线   1 credit · browse   2 credits · search   免费 · read

​
它为 Agent 做什么

预测市场 event 会把相关 market question 归到一张 agent 可读的卡片里。自然语言问题优先用 polymarket_event_search，例如“Bitcoin ETF approval”或“Fed rate cut odds”；只有用户要 list 或给了精确过滤条件时才用 polymarket_event_browse，例如 q=ETF、tag=policy 或 min_volume=10000。 Event card 是入口，不是终点。Browse 或 search 返回 event_card_id 后，继续调用 polymarket_event_read，让 agent 先看到事件说明、生命周期状态、标签和子 market 预览，再决定读哪个 market。

​
Agent flow

​
返回值

​
Browse 和 search 返回

​
data.events
PolymarketEvent[]
required
Browse 按生命周期和流动性排序。Search 按语义相关性排序。
​
meta.count
number
本次返回的 events 数量。
​
meta.nextCursor
string
Browse 有更多结果时返回的分页 cursor。
​
meta.scope
string
本产品固定为 finance。
​
meta.creditsUsed
number
Browse 为 1，search 为 2。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · event search
{
  "data": {
    "events": [
      {
        "event_card_id": "4b8f35c6-4781-4f3c-9237-142fc16467cd",
        "source_event_slug": "bitcoin-etf-approved-by-jan-15",
        "title": "Bitcoin ETF approved by Jan 15?",
        "description": "Markets related to whether a spot Bitcoin ETF is approved.",
        "market_count": 1,
        "markets": [
          {
            "market_card_id": "e370488a-33b5-4abd-8c5c-37c7ad8a60fc",
            "market_question": "Bitcoin ETF approved by Jan 15?",
            "outcomes": [
              { "label": "Yes", "outcome_token_id": "98787006152320761811798607481686168525551752574583108841982899511109091268658", "current_probability": 0.51 }
            ],
            "status": "closed",
            "volume": 1250000,
            "liquidity": 48000
          }
        ],
        "tags": ["crypto", "etf"],
        "status": "closed",
        "coverage_status": "partial",
        "semantic_score": 0.91
      }
    ]
  },
  "meta": { "count": 1, "scope": "finance", "creditsUsed": 2, "remainingCredits": 98 }
}

​
Event read 返回

​
data
PolymarketEvent
required
单张 event card，包含 browse/search 返回的字段，以及更完整的事件信息。
​
meta.creditsUsed
number
Event read 固定为 0。
​
meta.remainingCredits
number
账户剩余 credit。

​
说明

用户自然语言问题优先用 search。只有明确 list 或 exact lexical filters 时才用 browse（status=active、q=ETF、min_volume=10000）。选择 event 后先 read，让 agent 一次看到所有子问题。
如果需要 market 层面的 outcomes 和概率历史，带着 event card 里的 market_card_id 继续看 预测市场 Market 详情。
这个产品面向金融范围。它不覆盖体育、娱乐、钱包状态、订单簿或交易动作。
start_time 和 end_time 必须成对使用，并且 start_time 不能晚于 end_time。

​
直接调用

// 1) 搜索 event
{
  "method": "tools/call",
  "params": {
    "name": "polymarket_event_search",
    "arguments": { "query": "Bitcoin ETF approval", "status": "active_or_recently_closed", "limit": 5 }
  }
}

// 2) 读取选中的 event
{
  "method": "tools/call",
  "params": {
    "name": "polymarket_event_read",
    "arguments": { "event_card_id": "pme_902959" }
  }
}

​
完整参数参考

​
status
string
default:"active"
active、inactive、closed 或 active_or_recently_closed 之一。
​
q
string
可选 exact lexical filter，匹配 event title、slug、tags、child market questions 和 outcome labels。最多 200 字符。
​
tag
string
可选金融标签，例如 crypto 或 policy。
​
asset
string
可选资产或实体过滤，例如 BTC。
​
start_time
string
ISO 8601 UTC 起始时间。必须和 end_time 一起使用。
​
end_time
string
ISO 8601 UTC 结束时间。必须和 start_time 一起使用。
​
min_volume
number
可选的 event 级别市场成交量下限。
​
min_liquidity
number
可选的 event 级别市场流动性下限。
​
limit
number
default:20
返回 events 上限。范围 1-100。
​
cursor
string
来自 meta.nextCursor 的分页 cursor。
​
event_card_id
string
required
Browse 或 search 返回的 event id；也接受 alias pme_902959。

​
相关接口

预测市场 Market 详情

读取 market outcomes 和隐含概率历史。

MCP Server 接入

60 秒接入 Claude / Cursor / 任意 agent harness。