Prediction Markets Price History

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

PolymarketPriceHistory

required

Probability history for one outcome token.

Show PolymarketPriceHistory fields

string

required

The outcome token you requested.

string

required

1h or 1d.

PolymarketPricePoint[]

required

Ordered probability points. Each point includes time, probability, and price.

string

required

Availability state for the requested token and time range.

string

required

Short explanation of what data was available.

number

Number of returned points.

number

Always 0 for this call.

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.",
    "count": 2
  },
  "meta": { "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

HTTP / SDK examples

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

resp = requests.get(
    "https://api.llmquantdata.com/api/polymarket/price-history",
    headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
    params={
        "outcome_token_id": "98787006152320761811798607481686168525551752574583108841982899511109091268658",
        "interval": "1d",
        "start_time": "2024-01-01T00:00:00Z",
        "end_time": "2024-01-15T00:00:00Z",
    },
).json()
print(resp["data"]["points"][:2])

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

Read market outcomes and copy the outcome_token_id you need.

Getting Started

Connect

Personal Context

Knowledge Data

Crypto Prices