# Polymarket Whale Entries Feed

> Polymarket Whale Entries Feed is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Streams large trades made by skill-ranked Polymarket traders, including trader skill score, side, size, entry price, and post-entry market context.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-whale-entries
- 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/polymarket-whale-entries-feed-6da44353
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-e4K4D7RStitVILiE1buJ

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-entries-feed-6da44353 -d '<json body>'
```

Example prompt: Pull the latest Polymarket whale entries feed — I want to see large trades from skill-ranked traders, including their skill score, which side they took (YES or NO), how big the position is, their entry price, and what the market looked like right after they entered.

## When to prefer this

Choose this endpoint when you want a ready-made feed of large Polymarket trades attributed to skill-ranked traders, with trade metadata and post-entry context already assembled — rather than scraping raw Polymarket order data yourself. Best for copy-trading workflows, whale-watching dashboards, or signal generation where trader quality scoring matters.

## Known failure modes

- No recent whale entries available — returns empty feed if no qualifying large trades in the lookback window
- Invalid filter parameters — returns error if skill threshold or size threshold are malformed
- Payment failure — $0.02 USDC charge not processed, call rejected
- Rate limiting — too many calls in a short window returns a throttle error
- Market data lag — post-entry context may be incomplete for very recent trades

## How this service works

Polymarket whale entries feed — large trades from skill-ranked traders. Stream with trader skill score, side, size, entry price, post-entry market context. NOT guaranteed alpha. $0.02/call. Keywords: polymarket, whale, entries, feed, copy-trading.

## Output

Returns a feed of recent large Polymarket trades from skill-ranked traders, each entry containing the trader's skill score, trade side (YES/NO), position size, entry price, and post-entry market context such as subsequent price movement or volume shifts.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/polymarket-whale-entries-feed-6da44353/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)