预测市场事件

可作为 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 按语义相关性排序。

Show PolymarketEvent 字段

event_card_id

string

required

稳定的 LLMQuant event id。传给 polymarket_event_read 继续读取。

title

string

required

可读的事件标题。

description

string

有数据时返回事件层面的说明。

market_count

number

required

这张 event card 下的子 markets 数量。

markets

PolymarketMarketPreview[]

required

Market 预览，包含 market_card_id、market_question、outcomes、状态、流动性和成交量。

tags

string[]

required

金融标签，例如 crypto、policy 或 macro。

status

string

required

Event 状态：active、inactive 或 closed。

coverage_status

string

required

这张规范化 event card 的覆盖状态。

semantic_score

number

语义搜索结果中会返回。分数越高，越贴近 query。

data.count

number

本次返回的 events 数量。

data.nextCursor

string

Browse 有更多结果时返回的分页 cursor。

data.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",
        "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
      }
    ],
    "count": 1,
    "scope": "finance"
  },
  "meta": { "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。

直接调用

HTTP / SDK 示例

// 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" }
  }
}

import os, requests

base = "https://api.llmquantdata.com"
headers = {"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"}

events = requests.post(
    f"{base}/api/polymarket/events/search",
    headers=headers,
    json={"query": "Bitcoin ETF approval", "status": "active_or_recently_closed", "limit": 5},
).json()["data"]["events"]

event = requests.get(
    f"{base}/api/polymarket/events/{events[0]['event_card_id']}",
    headers=headers,
).json()["data"]
print(event["title"], event["market_count"])

curl -X POST "https://api.llmquantdata.com/api/polymarket/events/search" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Bitcoin ETF approval", "status": "active_or_recently_closed", "limit": 5}'

curl "https://api.llmquantdata.com/api/polymarket/events/pme_902959" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

完整参数参考

polymarket_event_browse — 请求参数

status

string

default:"active"

active、inactive、closed 或 active_or_recently_closed 之一。

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

来自 data.nextCursor 的分页 cursor。

polymarket_event_search — 请求参数

query

string

required

自然语言 query。最多 2,000 字符。

status

string

default:"active_or_recently_closed"

active、inactive、closed 或 active_or_recently_closed 之一。

tag

string

可选金融标签。

start_time

string

ISO 8601 UTC 起始时间。必须和 end_time 一起使用。

end_time

string

ISO 8601 UTC 结束时间。必须和 start_time 一起使用。

limit

number

default:5

返回 events 上限。范围 1-20。

polymarket_event_read — 请求参数

event_card_id

string

required

Browse 或 search 返回的 event id；也接受 alias pme_902959。

预测市场 Market 详情

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

MCP Server 接入

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

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标

SEC 申报文件

News

SEC Form 13F

它为 Agent 做什么

Agent flow

返回值

Browse 和 search 返回

Event read 返回

说明

直接调用

完整参数参考

相关接口

预测市场 Market 详情

MCP Server 接入

​它为 Agent 做什么

​Agent flow

​返回值

​Browse 和 search 返回

​Event read 返回

​说明

​直接调用

​完整参数参考

​相关接口

预测市场 Market 详情

MCP Server 接入

它为 Agent 做什么

Agent flow

返回值

Browse 和 search 返回

Event read 返回

说明

直接调用

完整参数参考

相关接口