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

PolymarketMarket

required

One market card.

Show PolymarketMarket fields

string

required

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

string

required

Parent event id.

string

required

The market question agents should quote or summarize.

PolymarketOutcome[]

required

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

string

required

Market status: active, inactive, or closed.

number

Reported market volume when available.

number

Reported market liquidity when available.

string

required

Coverage state for this market card.

number

Always 0 for market read.

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

PolymarketPriceHistory

required

Probability history for one outcome token.

Show PolymarketPriceHistory fields

string

required

Outcome token requested.

string

required

1h or 1d.

PolymarketPricePoint[]

required

Ordered probability points.

string

required

Data availability state for the requested token and range.

string

required

Plain-English explanation of availability.

number

Number of returned points.

number

Always 0 for price history.

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

string

required

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

polymarket_price_history — request parameters

string

required

Outcome token id returned by polymarket_market_read.

string

required

1h or 1d.

string

ISO 8601 UTC start. Must be used with end_time.

string

ISO 8601 UTC end. Must be used with start_time.

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