# Predge Whale Data – Wallet Trade History

> Predge Whale Data – Wallet Trade History is a paid API for AI agents from x402-api-production-266e.up.railway.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns historical Polymarket trades for a specific wallet address with running win-rate and modeled PnL curve computed from resolved markets

## Facts

- Endpoint: GET https://x402-api-production-266e.up.railway.app/v1/wallets/:address/history
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-whale-data-wallet-trade-history-72892b5e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_N5uZXzWeTkpLKKjkoFm3I

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

Example prompt: Pull the last 90 days of Polymarket trade history for wallet 0x3a4e...f9c2 on Predge — I want to see their win rate and modeled PnL curve across resolved markets.

## When to prefer this

Use this endpoint when you need the full historical trade record and running performance metrics (win rate, modeled PnL) for a specific Polymarket proxy wallet. Prefer this over the wallet profile endpoint when you need the raw trades array for further analysis, or over the leaderboard endpoint when you already know the wallet address. Note that modeled_pnl_usd is an estimate (assumes $1 binary payout per winning share) and should not be treated as realized/settled P&L.

## Known failure modes

- 404 if wallet address is not known to Predge dataset (not charged)
- Invalid 0x address format returns error
- Window parameter value outside enum (30d|90d|all) causes bad request
- Rate limiting or payment failure returns 402
- Trades array capped at 500 but summary still covers full window — agent must use summary fields for totals, not array length

## How this service works

Historical trades for one wallet (path param: 0x… proxy-wallet address) plus a running win-rate & MODELED-PnL curve, computed ONLY from RESOLVED markets (modeled_pnl_usd is a MODELED estimate, NOT realized/settled P&L — it assumes a $1 binary payout per winning share, shares = size_usd ÷ entry price; not a substitute for on-chain settled P&L). Unresolved trades still appear (won: null, modeled_pnl_usd: null) but do not move the curve. Query param: window (30d|90d|all, default 30d — "all" is UNBOUNDED, window_days: null). The trades array is capped at 500 most-recent-first, but summary is computed over EVERY trade in the window (see summary.trades_returned / trades_capped), so the total matches this wallet's profile. 15 min delay. 404 (not charged) for wallets unknown to the Predge dataset. outcome_verified: {win_rate: true, pnl: false}.

## Output

Returns up to 500 most-recent trades (capped, but summary computed over all trades in window) including market info, side, size_usd, entry price, won status (null if unresolved), and modeled_pnl_usd (null if unresolved). Also includes summary object with win_rate (verified), modeled PnL curve, trades_returned, and trades_capped flag. 15-minute data delay. 404 returned (not billed) for wallets not in Predge dataset.

## 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": [
        "30d",
        "90d",
        "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-wallet-trade-history-72892b5e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-api-production-266e.up.railway.app](https://www.zero.xyz/host/x402-api-production-266e.up.railway.app/llms.txt)