Skip to main content
Available as MCP tool: polymarket_price_history - call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   free

​
What it does for your agent

polymarket_price_history returns how one outcome’s implied probability changed over time. Use it after your agent has selected a market outcome and needs a clean timeline for a chart, event recap, or probability-move explanation. Pass an outcome_token_id, choose 1h or 1d, and optionally set a UTC time range. The response gives ordered points with time, probability, and price.

​
Response

​
data
PolymarketPriceHistory
required
Probability history for one outcome token.
​
meta.count
number
Number of returned points.
​
meta.creditsUsed
number
Always 0 for this call.
​
meta.remainingCredits
number
Account credits remaining.
200 OK · polymarket_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, read the selected market, then pass one returned outcome_token_id here.
Use 1d for a simple timeline. Use 1h when the agent needs to explain movement around a specific day or announcement.
interval only accepts 1h and 1d. Requests such as interval=15m return 400 before any credit is charged.
This returns implied-probability points for one outcome. It is not OHLCV data, an order book, trade history, or investment advice.

​
Direct invocation

{
  "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

​
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 Market Details

Read market outcomes and copy the outcome_token_id you need.