# Polymarket Price History API

> Polymarket Price History API is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns historical price/odds time series for a Polymarket outcome token at configurable intervals (1h, 6h, 1d, 1w, or max), enabling probability-over-time charting.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-price-history
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-price-history-api-b8bc5a8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KIzb6gqFfBDHVfxRHNXeK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability polymarket-price-history-api-b8bc5a8c -d '<json body>'
```

Example prompt: Pull the daily price history for this Polymarket outcome token — I want to see how the probability moved over the past month so I can chart it.

## When to prefer this

Choose this endpoint when you need historical probability or price time series for a Polymarket outcome token and want a simple proxied API with per-call pricing rather than managing direct Polymarket CLOB API access. Ideal for charting, backtesting, or analyzing how market consensus shifted over a defined period.

## Known failure modes

- Invalid or unknown token ID returns an error or empty series
- Unsupported interval value causes a validation error
- Network timeout if upstream Polymarket CLOB is slow
- Payment failure (x402) if USDC balance is insufficient
- Empty result if the token has no trading history at the requested resolution

## How this service works

Historical price/odds time series for a Polymarket outcome token at a chosen interval (1h/6h/1d/1w/max). Chart how probability moved. Free Polymarket CLOB data.

## Output

A time series of price/odds data points for the specified Polymarket outcome token, with timestamps and probability values at the chosen interval (1h, 6h, 1d, 1w, or max). Enables visualization of how the market's implied probability evolved over time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-price-history-api-b8bc5a8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)