# Predge Wallet Trade History

> Predge Wallet Trade History is a paid API for AI agents from api.predge.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves a scored wallet's full trade history on Polymarket with modeled PnL, win rate, and per-trade metadata over a configurable lookback window

## Facts

- Endpoint: GET https://api.predge.io/v1/wallets/%7Baddress%7D/history
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-wallet-trade-history-df03b4d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_maqIDWmbmDonjxt-CVtWC

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-wallet-trade-history-df03b4d5
```

Example prompt: Pull up the last 30 days of trade history for Polymarket wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 — I want to see the wallet score, win rate, and modeled PnL on each resolved market.

## When to prefer this

Use this endpoint when you need granular per-trade history and performance scoring for a specific Polymarket wallet address. Prefer this over general blockchain explorers when you need prediction-market-specific context like market titles, resolution outcomes, win rates, and the proprietary 0-100 wallet score that signals smart money or insider activity. Best when researching whether to copy-trade a whale or assess the credibility of a wallet flagged in an alert.

## Known failure modes

- Invalid or malformed wallet address returns a 400 or empty result
- Unknown wallet with no Polymarket history returns empty trades array
- Invalid window parameter value outside enum causes validation error
- Rate limit exceeded or payment failure returns 402/429
- Modeled PnL is an estimate (not settled P&L) and may not reflect actual realized gains

## 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 a list of trades with fields including market title, side (yes/no), entry price, size in USD, resolution outcome, whether the trade won, modeled PnL, running modeled PnL, wallet score, and wallet win rate. Also includes a summary block with total trades count, wins, win rate, total modeled PnL, and a flag indicating whether the full trade list was capped. Outcome verification flags indicate which metrics (win rate vs PnL) are verified vs modeled estimates.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "modeled_pnl_usd is a MODELED estimate ($1 binary payout per winning share, shares = size_usd ÷ entry price, over resolved markets), NOT realized/settled P&L.",
  "trades": [
   {
    "won": true,
    "side": "yes",
    "price": 0.62,
    "wallet": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
    "tx_hash": "0x6a7de5…",
    "category": "economics",
    "platform": "polymarket",
    "size_usd": 25400,
    "resolution": "yes",
    "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",
    "modeled_pnl_usd": 15575.9,
    "wallet_win_rate_30d": 0.67,
    "running_modeled_pnl_usd": 4820.5
   }
  ],
  "window": "30d",
  "address": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
  "summary": {
   "wins": 12,
   "win_rate": 0.71,
   "trades_count": 24,
   "trades_capped": false,
   "decided_trades": 17,
   "modeled_pnl_usd": 4820.5,
   "trades_returned": 24
  },
  "window_days": 30,
  "outcome_verified": {
   "pnl": false,
   "win_rate": true
  }
 }
}
```

## More

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