# Polymarket Whale Trade Monitor

> Polymarket Whale Trade Monitor is a paid API for AI agents from api.hergertsynthora.com, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Returns recent large-size trades (whale trades) on Polymarket prediction markets, filterable by side and minimum USD size

## Facts

- Endpoint: POST https://api.hergertsynthora.com/v1/polymarket-whales
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-whale-trade-monitor-47f73daa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nWPzZ22UasBX3YcJoHYzE

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 polymarket-whale-trade-monitor-47f73daa -d '<json body>'
```

Example prompt: Pull the top 50 whale trades on Polymarket right now — only buy-side trades worth at least $10,000 each — and tell me which markets and wallets are most active.

## When to prefer this

Choose this endpoint when you need on-chain Polymarket trade data specifically filtered to large-size ('whale') activity, with wallet-level detail and market attribution. Prefer it over generic blockchain explorers when you want pre-filtered, structured whale intelligence without writing custom subgraph queries.

## Known failure modes

- Invalid 'side' value (not 'buy', 'sell', or 'all') returns a validation error
- limit out of range (less than 1 or greater than 100) returns a parameter error
- min_usd set to an unreasonably high value may return zero results
- Network or upstream data source outage returns a non-ok response
- Payment failure (insufficient USDC balance or x402 protocol error) blocks the call

## How this service works

Live whale-tracking on Polymarket: the latest large trades (default >= 5000 USD, tunable via min_usd) with wallet, side, outcome, size, price, USD value, market title/slug and tx hash, straight from Polymarket public trades data API. Built for prediction-market agents that track smart money before trading. No charge on service failure. Ed25519-signed. $0.15 USDC per call via x402 on Base. Free trial: 3 calls per wallet with header X-WALLET.

## Output

A JSON object containing the count of matched whale trades, total USD volume, minimum USD threshold used, an array of individual trades (each with transaction hash, side, size, price, market name, wallet address, outcome label, USD value, market slug, and UTC timestamp), the number of unique wallets involved, and a ranked list of top markets by whale USD volume.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "side": {
   "type": "string",
   "description": "buy | sell | all (default all)"
  },
  "limit": {
   "type": "integer",
   "description": "Max trades to return (1-100, default 25)"
  },
  "min_usd": {
   "type": "number",
   "description": "Minimum trade size in USD (default 5000)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "polymarket_whales",
  "result": {
   "count": 20,
   "min_usd": 10000,
   "total_usd": 250000,
   "whale_trades": [
    {
     "tx": "0x...",
     "side": "BUY",
     "size": 10000,
     "price": 0.62,
     "market": "...",
     "wallet": "0x...",
     "outcome": "Yes",
     "usd_value": 6200,
     "market_slug": "...",
     "timestamp_utc": "..."
    }
   ],
   "unique_wallets": 14,
   "top_markets_by_whale_usd": []
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-whale-trade-monitor-47f73daa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hergertsynthora.com](https://www.zero.xyz/host/api.hergertsynthora.com/llms.txt)