Prediction Markets Market Details

Available as MCP tools: polymarket_market_read + polymarket_price_history - call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.

Live free · market read free · price history

What it does for your agent

polymarket_market_read loads one market selected from a Prediction Markets event card. It returns the market question, status, outcomes, outcome token ids, tags, liquidity, volume, and event context so an agent can decide which side of the market to inspect. polymarket_price_history takes one outcome_token_id from that market and returns implied-probability points at 1h or 1d resolution. Use it to show how market-implied odds moved over time; do not treat it as OHLCV candles, order book depth, or executable quotes.

Agent flow

Response

Market read response

data

PolymarketMarket

required

One market card.

Show PolymarketMarket fields

market_card_id

string

required

Stable LLMQuant market id. Use this after reading an event card.

event_card_id

string

required

Parent event id.

market_question

string

required

The market question agents should quote or summarize.

outcomes

PolymarketOutcome[]

required

Outcome sides. Each outcome can include label, outcome_token_id, current_probability, and latest price metadata.

status

string

required

Market status: active, inactive, or closed.

volume

number

Reported market volume when available.

liquidity

number

Reported market liquidity when available.

coverage_status

string

required

Coverage state for this market card.

meta.creditsUsed

number

Always 0 for market read.

meta.remainingCredits

number

Account credits remaining.

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 response

data

PolymarketPriceHistory

required

Probability history for one outcome token.

Show PolymarketPriceHistory fields

outcome_token_id

string

required

Outcome token requested.

interval

string

required

1h or 1d.

points

PolymarketPricePoint[]

required

Ordered probability points.

coverage_status

string

required

Data availability state for the requested token and range.

coverage_notice

string

required

Plain-English explanation of availability.

data.count

number

Number of returned points.

meta.creditsUsed

number

Always 0 for price history.

meta.remainingCredits

number

Account credits remaining.

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

Notes

Start from Prediction Markets Events. Market ids and outcome token ids are selected from event cards, not guessed.

Use 1d for narrative timelines and 1h when the agent needs intraday movement around a dated event.

interval only accepts 1h and 1d. Requests such as interval=15m return 400 before any credit is charged.

Price history returns implied-probability points for one outcome token. It is not OHLCV, order book data, trade history, or investment advice.

Direct invocation

HTTP / SDK examples

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

// 2) Load daily probability history for the 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"

Full parameter reference

polymarket_market_read — request parameters

market_card_id

string

required

Market id returned by an event card; the alias pmm_253254 is also accepted.

polymarket_price_history — request parameters

outcome_token_id

string

required

Outcome token id returned by polymarket_market_read.

interval

string

required

1h or 1d.

start_time

string

ISO 8601 UTC start. Must be used with end_time.

end_time

string

ISO 8601 UTC end. Must be used with start_time.

limit

number

Optional maximum points returned. Range 1-20000.

Prediction Markets Events

Browse, search, and read event cards before selecting a market.

Prediction Markets Price History

Query probability history after selecting an outcome token.

Getting Started

Connect

Personal Context

Knowledge Data

Crypto Prices