# Predge Whale Data — Polymarket Market Price/Volume History

> Predge Whale Data — Polymarket Market Price/Volume History is a paid API for AI agents from api.predge.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Returns daily-bucketed trade-print price and volume history (including whale volume) for a single Polymarket prediction market, with up to 200 individual prints and resolution data.

## Facts

- Endpoint: GET https://api.predge.io/v1/markets/:conditionId/history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-whale-data-polymarket-market-price-volume-history-c7523860
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-sJCyOzk6IKy2IgV_bcDU

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 predge-whale-data-polymarket-market-price-volume-history-c7523860
```

Example prompt: Pull the last 30 days of price and whale volume history for Polymarket condition 0x3a4b... — I want to see how the YES price moved daily and whether big traders were active.

## When to prefer this

Use this endpoint when you need historical trade-print price and volume data — especially whale volume — for a specific Polymarket market identified by its 0x condition ID. Prefer it over generic Polymarket APIs when whale-segmented volume and insider-signal context are needed alongside price history, or when you need resolution status directly from the markets row.

## Known failure modes

- 404 returned (not charged) if the condition ID is unknown or not tracked by Predge
- Invalid window enum value may result in a 400 or defaulting to 30d
- 'all' window is capped at 180 days regardless of market age
- Stale data up to 15 minutes behind real-time trades

## How this service works

Price/volume history for one Polymarket market (path param: 0x… condition id). Trade-print price series in daily buckets (price normalized to the YES side, NOT orderbook quotes — outcome_verified.flow: false) with per-bucket volume and whale volume, plus up to 200 individual prints; includes resolution/resolved_at straight off the markets row when settled (outcome_verified.resolution: true). Query param: window (7d|30d|all, default 30d — "all" bounded to 180 days). 15 min delay. 404 (not charged) if unknown.

## Output

A time series of daily price buckets with YES-normalized trade-print prices (not orderbook quotes), per-bucket total volume, and per-bucket whale volume; up to 200 individual trade prints; and resolution metadata (resolved boolean, resolved_at timestamp) when the market has settled. Data has a 15-minute delay.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "window": {
       "enum": [
        "7d",
        "30d",
        "all"
       ],
       "type": "string",
       "description": "Lookback window (default 30d)"
      }
     }
    }
   },
   "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/predge-whale-data-polymarket-market-price-volume-history-c7523860/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.predge.io](https://www.zero.xyz/host/api.predge.io/llms.txt)