# Predge Market Trade History

> Predge Market Trade 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-15).

Returns historical trade data for a specific Polymarket prediction market, including whale wallet activity, price buckets, and wallet scoring over a configurable time window.

## Facts

- Endpoint: GET https://api.predge.io/v1/markets/%7BconditionId%7D/history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-market-trade-history-be184c18
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mw8I-aj-WP9RnjOH_ES1r

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-market-trade-history-be184c18
```

Example prompt: Pull the last 30 days of whale trade history for the Polymarket market with condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — I want to see who the big wallets are, their scores, and how volume has trended.

## When to prefer this

Choose this endpoint when you need granular per-trade whale intelligence for a specific Polymarket market identified by its conditionId, including wallet quality scores and bucketed volume trends. Prefer this over generic on-chain data sources when you want pre-computed whale scoring, win-rate context, and insider-flow heuristics rather than raw blockchain transaction data.

## Known failure modes

- Invalid or malformed conditionId returns a 404 or empty market response
- Unknown conditionId for a market not tracked by Predge returns no data
- Invalid window enum value (e.g. not 7d/30d/all) may return a 400 error
- Market with no trades in the requested window returns empty trades array
- Payment not received (x402 protocol failure) results in 402 response requiring USDC payment
- Rate limiting or plan quota exceeded may result in 429 response

## How this service works

Real-time alerts on whale traders on Polymarket. Heuristic Insider Watch, wallet scoring 0–100, Bloomberg-style web terminal. Free plan included.

## Output

Returns a JSON object containing market metadata (title, status, yes_price, category), a list of individual trades with wallet address, side, size in USD, transaction hash, wallet score (0-100), and 30-day win rate, plus time-bucketed volume aggregates showing total and whale-specific volume and average price per bucket, plus a flag indicating whether outcome flow or resolution has been verified.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "market": {
   "title": "Will the Fed cut rates in September?",
   "status": "active",
   "category": "economics",
   "platform": "polymarket",
   "yes_price": 0.62,
   "resolution": null,
   "resolved_at": null,
   "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39"
  },
  "trades": [
   {
    "side": "yes",
    "price": 0.62,
    "wallet": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
    "tx_hash": "0x6a7de5…",
    "category": "economics",
    "platform": "polymarket",
    "size_usd": 25400,
    "market_slug": "fed-rate-cut-september",
    "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39",
    "market_title": "Will the Fed cut rates in September?",
    "wallet_score": 81,
    "block_timestamp": "2026-07-17T09:41:02.000Z",
    "wallet_win_rate_30d": 0.67
   }
  ],
  "window": "30d",
  "buckets": [
   {
    "trades": 9,
    "avg_price": 0.58,
    "volume_usd": 96400,
    "bucket_start": "2026-07-17T00:00:00.000Z",
    "whale_volume_usd": 71000
   }
  ],
  "window_days": 30,
  "outcome_verified": {
   "flow": false,
   "resolution": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-market-trade-history-be184c18/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)