# SYNTHORA Polymarket Whales Tracker

> SYNTHORA Polymarket Whales Tracker is a paid API for AI agents from polymarket-whales.hergertsynthora.com, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Returns live large-trade (whale) activity on Polymarket prediction markets, filterable by minimum USD size, side, and count limit.

## Facts

- Endpoint: POST https://polymarket-whales.hergertsynthora.com/service
- 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/synthora-polymarket-whales-tracker-ac704778
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1YscaTEqOIQXgxcUMEfSo

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 synthora-polymarket-whales-tracker-ac704778 -d '<json body>'
```

Example prompt: Show me the top 30 whale trades on Polymarket right now — only buy-side trades worth at least $10,000 each, including the wallet addresses and which markets they're betting on.

## When to prefer this

Choose this endpoint when you need real-time, filtered visibility into large on-chain trades specifically on the Polymarket prediction market platform — especially when you want wallet-level attribution, market context, and USD-denominated sizing in a single call. Prefer it over generic blockchain explorers when you need pre-parsed, human-readable Polymarket trade data without building your own indexing logic.

## Known failure modes

- Invalid 'side' value (not 'buy', 'sell', or 'all') returns a validation error
- limit out of range (below 1 or above 100) returns a bad request error
- Polymarket upstream API unavailable causes 5xx or empty result
- min_usd set extremely high may return zero whale trades (count: 0)
- Network timeout if Polymarket data API is slow to respond

## 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.

## Output

A JSON object containing a list of whale trades each with transaction hash, wallet address, buy/sell side, outcome name, share size, price, USD value, market title and slug, and UTC timestamp — plus aggregate stats: total trade count, total USD volume, number of unique wallets involved, and a ranked list of top markets by whale USD.

## 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/synthora-polymarket-whales-tracker-ac704778/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from polymarket-whales.hergertsynthora.com](https://www.zero.xyz/host/polymarket-whales.hergertsynthora.com/llms.txt)