Skip to main content
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.
​
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.
​
meta.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."
  },
  "meta": { "count": 2, "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

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

​
Full parameter reference

​
market_card_id
string
required
Market id returned by an event card; the alias pmm_253254 is also accepted.
​
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.