`polymarket_price_history`

Pack: polymarket · Endpoint: https://gateway.pipeworx.io/polymarket/mcp

Historical probability time-series for one Polymarket market. Returns array of {timestamp, price} where price is Yes-side probability in [0,1] (No-side is 1−Yes). Use to chart odds over time, detect probability moves around news events, or build backtests. Intervals 1h | 6h | 1d | 1w | 1m | max — supports up to a month (1m) and full history (max). A young market may have less data than the requested window; the coverage field reports the actual span and whether it is the full available history (a data limit, not a tool limit).

Parameters

Name	Type	Required	Description
`slug_or_id`	string	yes	Market slug or numeric id (same as polymarket_market)
`interval`	string	no	1h \| 6h \| 1d \| 1w \| 1m \| max (default 1d). Higher fidelity for shorter windows.

Example call

Arguments

{
  "slug_or_id": "will-bitcoin-hit-150k-by-june-30-2026"
}

curl

curl -X POST https://gateway.pipeworx.io/polymarket/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"polymarket_price_history","arguments":{"slug_or_id":"will-bitcoin-hit-150k-by-june-30-2026"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('polymarket_price_history', {
  "slug_or_id": "will-bitcoin-hit-150k-by-june-30-2026"
});

More examples

{
  "slug_or_id": "will-bitcoin-hit-150k-by-june-30-2026",
  "interval": "1h"
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "not_found"
          ],
          "description": "Error code"
        },
        "message": {
          "type": "string",
          "description": "Error message"
        }
      },
      "required": [
        "error",
        "message"
      ]
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "no_token"
          ],
          "description": "Error code"
        },
        "message": {
          "type": "string",
          "description": "Error message"
        }
      },
      "required": [
        "error",
        "message"
      ]
    },
    {
      "type": "object",
      "properties": {
        "market_id": {
          "type": "string",
          "description": "Market ID"
        },
        "market_slug": {
          "type": "string",
          "description": "Market slug"
        },
        "question": {
          "type": "string",
          "description": "Market question"
        },
        "interval": {
          "type": "string",
          "description": "Time interval selected"
        },
        "point_count": {
          "type": "number",
          "description": "Number of data points"
        },
        "history": {
          "type": "array",
          "description": "Price history time series",
          "items": {
            "type": "object",
            "properties": {
              "timestamp": {
                "type": "string",
                "description": "ISO 8601 timestamp"
              },
              "unix": {
                "type": "number",
                "description": "Unix seconds"
              },
              "yes_probability": {
                "type": "number",
                "description": "Yes token probability in [0,1]"
              }
            },
            "required": [
              "timestamp",
              "unix",
              "yes_probability"
            ]
          }
        }
      },
      "required": [
        "market_id",
        "market_slug",
        "question",
        "interval",
        "point_count",
        "history"
      ]
    }
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "polymarket": {
      "url": "https://gateway.pipeworx.io/polymarket/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

polymarket_price_history