# x402pulse Skilled Whale Trades on Polymarket

> x402pulse Skilled Whale Trades on Polymarket is a paid API for AI agents from www.x402pulse.dev, paid per call via x402, $0.0525/call, status unknown (last checked 2026-10-12).

Returns recent large Polymarket trades made exclusively by skill-scored (Solid or Sharp) traders, with each trade tagged by skill score, edge over odds, return, and specialty.

## Facts

- Endpoint: GET https://www.x402pulse.dev/v1/skilled-whales?utm_source=zero.xyz
- Price: $0.0525/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402pulse-skilled-whale-trades-on-polymarket-5751fcae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LX1jkk1Z7W7NViiJvBaPt

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 x402pulse-skilled-whale-trades-on-polymarket-5751fcae
```

Example prompt: Show me the last 20 large Polymarket trades made only by skilled or sharp traders — I want each one's skill score, their edge over the odds they paid, and what their specialty is. Set the minimum trade size to $500.

## When to prefer this

Choose this endpoint when you specifically want large Polymarket trades filtered by demonstrated trader skill — not just raw whale volume. It is superior to generic Polymarket trade feeds when you care about signal quality: you want to follow traders who have proven edge, not just deep pockets. Use it over leaderboard endpoints when you need the actual trade-level records rather than aggregated rankings.

## Known failure modes

- No trades returned if minimum trade size is set too high with few qualifying skilled-whale trades in recent history
- limit parameter out of range (must be 1–50) causes validation error
- Payment failure or missing x402 payment header results in 402 response
- Stale data if the underlying Polymarket feed hasn't refreshed recently

## How this service works

Smart-money whale trades on Polymarket: recent large trades by skilled (Solid or Sharp) traders only, each tagged with the trader's skill score, edge over the odds paid, return and specialty. Separates informed whales from big gamblers.

## Output

A list of recent large Polymarket trades filtered to only Solid or Sharp skilled traders, each record including the trade size, the market traded, the trader's skill score, their edge over the odds paid, their return metric, and their specialty area — effectively separating informed whale activity from large but unskilled bets.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "min": {
       "type": "string",
       "description": "Minimum trade size in USD"
      },
      "limit": {
       "type": "string",
       "description": "Number of trades, 1 to 50"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "minUsd": 1000,
   "trades": [
    {
     "roi": 0.65,
     "usd": 18500,
     "edge": 0.13,
     "name": "primm",
     "side": "BUY",
     "time": "2026-10-01T12:00:00.000Z",
     "label": "Sharp",
     "price": 0.44,
     "skill": 88,
     "market": "Example market?",
     "wallet": "0xd38b71f3e8ed1af71983e5c309eac3dfa9b35029",
     "outcome": "Yes",
     "specialty": "sports"
    }
   ],
   "tradersScored": 25
  },
  "cached": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402pulse-skilled-whale-trades-on-polymarket-5751fcae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402pulse.dev](https://www.zero.xyz/host/www.x402pulse.dev/llms.txt)