# Predge Whale Wallet Profile API

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

Returns a comprehensive smart-money profile for a single Polymarket proxy-wallet address, including whale score, win rates, modeled PnL, trade history, and favorite categories.

## Facts

- Endpoint: GET https://x402-api-production-266e.up.railway.app/v1/wallets/%7Baddress%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-whale-wallet-profile-api-254110b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XeYMVoTnYmVj0tfpnwr9G

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-wallet-profile-api-254110b8
```

Example prompt: Look up the Predge whale profile for Polymarket wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 — I want to see their whale score, 30-day win rate, modeled PnL, and which market categories they trade most.

## When to prefer this

Use this endpoint when you need a complete smart-money dossier on a specific Polymarket wallet — combining score, win rate, PnL proxy, trade history, and category focus in a single call. Prefer it over the leaderboard endpoint when you have a specific address to investigate rather than wanting ranked lists, and over the market-whale endpoint when your primary axis is the wallet identity rather than a specific market. The x402 micropayment model means no API key setup is required.

## Known failure modes

- Wallet address not found or never traded on Polymarket — returns found:false with no score or trade data
- Malformed or non-0x wallet address in path — likely 400 or 422 error
- Payment not processed via x402 protocol — 402 Payment Required response
- Wallet has insufficient trade history for a reliable score — score may be low or absent
- Data reflects up to 15-minute delay for recent trades; very recent activity may not appear

## How this service works

Polymarket whale trades and smart-money signals from the Predge tracking pipeline, sold per-call over the x402 payment protocol. No API keys, no accounts.

## Output

A JSON object containing the wallet address, a Predge whale score (0–100), win rates broken down by 7d/30d and scorer 30d/90d, modeled PnL for 30d and all-time (signed-volume proxy, not realized P&L), total trades all time, average position size in USD, first-seen timestamp, recent individual trades with market slugs and sizes, favorite market categories with volume, and outcome verification flags indicating which metrics are independently verified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "modeled_pnl_* is a MODELED signed-volume proxy from the Predge scorer (+size on wins, −size on losses over resolved markets), NOT realized/settled P&L.",
  "found": true,
  "score": 81,
  "totals": {
   "first_seen_at": "2026-05-02T10:11:00.000Z",
   "trades_all_time": 214,
   "avg_position_usd": 12800,
   "modeled_pnl_30d_usd": 48100.5,
   "modeled_pnl_all_time_usd": 302400
  },
  "address": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
  "win_rate": {
   "7d": 0.67,
   "30d": 0.71,
   "scorer_30d": 0.7,
   "scorer_90d": 0.64
  },
  "recent_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
   }
  ],
  "outcome_verified": {
   "pnl": false,
   "win_rate": true
  },
  "score_updated_at": "2026-07-18T00:00:04.000Z",
  "favorite_categories": [
   {
    "trades": 88,
    "category": "economics",
    "volume_usd": 1204000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-whale-wallet-profile-api-254110b8/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)