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, optionally set one or two UTC time boundaries, then use limit and take_from to choose which edge to keep. 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: available, partial, not_available, or unsupported.

string

required

Short explanation of what data was available.

number

Number of returned points.

number

Always 0 for this call.

number

Account credits remaining.

string

Present only when the candidate window held more bars than were returned — i.e. limit truncated the result. The message tells the agent to narrow the window or split the query: More data exists in the requested window than the items returned; narrow the window or split the query to see more.

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",
      "limit": 10,
      "take_from": "earliest"
    }
  }
}

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",
        "limit": 10,
        "take_from": "earliest",
    },
).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&limit=10&take_from=earliest" \
  -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

Optional inclusive ISO 8601 UTC lower boundary.

string

Optional inclusive ISO 8601 UTC upper boundary.

number

Maximum points returned after boundary filtering. Default 720 for 1h, 365 for 1d; max 20000.

string

default:"latest"

Which side of the filtered window to keep when more than limit points match. Use latest or earliest; output remains chronological.

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