预测市场 Market 详情

可作为 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。

Show PolymarketMarket 字段

market_card_id

string

required

稳定的 LLMQuant market id。先读取 event card，再用它选择 market。

event_card_id

string

required

父级 event id。

market_question

string

required

Agent 应该引用或总结的 market 问题。

outcomes

PolymarketOutcome[]

required

Market 的不同结果。每个 outcome 可包含 label、outcome_token_id、current_probability 和最近的概率信息。

status

string

required

Market 状态：active、inactive 或 closed。

volume

number

有数据时返回 market 成交量。

liquidity

number

有数据时返回 market 流动性。

coverage_status

string

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 的概率历史。

Show PolymarketPriceHistory 字段

outcome_token_id

string

required

请求的 outcome token。

interval

string

required

1h 或 1d。

points

PolymarketPricePoint[]

required

按时间排列的概率点。

coverage_status

string

required

这个 token 和时间范围的数据可用状态。

coverage_notice

string

required

面向用户和 agent 的可用性说明。

data.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.",
    "count": 2
  },
  "meta": { "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、订单簿数据、成交历史或投资建议。

直接调用

HTTP / SDK 示例

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

import os, requests

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

market = requests.get(
    f"{base}/api/polymarket/markets/pmm_253254",
    headers=headers,
).json()["data"]
token = market["outcomes"][0]["outcome_token_id"]

history = requests.get(
    f"{base}/api/polymarket/price-history",
    headers=headers,
    params={
        "outcome_token_id": token,
        "interval": "1d",
        "start_time": "2024-01-01T00:00:00Z",
        "end_time": "2024-01-15T00:00:00Z",
    },
).json()["data"]
print(history["points"][:2])

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

curl "https://api.llmquantdata.com/api/polymarket/price-history?outcome_token_id=98787006152320761811798607481686168525551752574583108841982899511109091268658&interval=1d&start_time=2024-01-01T00%3A00%3A00Z&end_time=2024-01-15T00%3A00%3A00Z" \
  -H "Authorization: Bearer $LLMQUANT_API_KEY"

完整参数参考

polymarket_market_read — 请求参数

market_card_id

string

required

Event card 返回的 market id；也接受 alias pmm_253254。

polymarket_price_history — 请求参数

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 后，查询它的概率历史。

快速开始

接入

个人 Context

知识数据

Crypto 行情

预测市场

美股行情

ETF

宏观指标

SEC 申报文件

News

SEC Form 13F

预测市场 Market 详情

它为 Agent 做什么

Agent flow

返回值

Market read 返回

Price history 返回

说明

直接调用

完整参数参考

相关接口

预测市场事件

预测市场概率历史

​它为 Agent 做什么

​Agent flow

​返回值

​Market read 返回

​Price history 返回

​说明

​直接调用

​完整参数参考

​相关接口

预测市场事件

预测市场概率历史

它为 Agent 做什么

Agent flow

返回值

Market read 返回

Price history 返回

说明

直接调用

完整参数参考

相关接口