# polynews.news Price History

> polynews.news Price History is a paid API for AI agents from polynews.news, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns historical price data for a Polymarket prediction market with configurable timeframes (1H, 6H, 1D, 1W, 1M, ALL)

## Facts

- Endpoint: GET https://polynews.news/api/v1/price-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polynews-news-e9942680
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MYTLgLKQOkFn1B5ob7n91

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 polynews-news-e9942680
```

Example prompt: Can you pull the 1-week price history for Polymarket market ID 'will-trump-win-2024' so I can see how the probability has moved over time?

## When to prefer this

Use this endpoint when you need raw historical price/probability data for a specific Polymarket prediction market to chart trends, analyze price movements, or feed into further analysis. Prefer this over the catalyst analysis endpoint when you want the underlying data series rather than an AI-generated explanation of price movements.

## Known failure modes

- Invalid or unknown marketId returns empty or error response
- Unsupported range value may return error or default behavior
- Market has no historical data for the requested range
- Rate limiting or payment failure (x402) if USDC payment not processed
- Network timeout for markets with very large histories

## How this service works

Historical price data with configurable timeframes (1H/6H/1D/1W/1M/ALL)

## Output

An array of price-timestamp pairs where each entry contains a Unix timestamp (t) and a probability price between 0 and 1 (p), along with the range label used for the query. Suitable for charting or time-series analysis of prediction market probability movements.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "range": {
       "type": "string"
      },
      "marketId": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "marketId": {
         "type": "string"
        },
        "outcomes": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "history": {
            "type": "array",
            "items": {
             "type": "object",
             "properties": {
              "price": {
               "type": "number",
               "description": "Price as percentage (0-100)"
              },
              "timestamp": {
               "type": "number",
               "description": "Unix ms"
              }
             }
            }
           },
           "outcomeId": {
            "type": "string"
           },
           "outcomeName": {
            "type": "string"
           }
          }
         },
         "description": "Per-outcome price series (top outcomes by price)"
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "range": "1D",
   "history": [
    {
     "p": 0.68,
     "t": 1747008000
    },
    {
     "p": 0.71,
     "t": 1747011600
    },
    {
     "p": 0.72,
     "t": 1747015200
    }
   ],
   "marketId": "69317"
  },
  "meta": {
   "tier": "standard",
   "version": "v1",
   "endpoint": "/api/v1/price-history",
   "latencyMs": 240,
   "timestamp": "2026-05-12T04:30:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polynews-news-e9942680/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from polynews.news](https://www.zero.xyz/host/polynews.news/llms.txt)