# Polymarket Whale Entries

> Polymarket Whale Entries is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.136/call, status unknown (last checked 2026-09-15).

Retrieves large-position ('whale') entry data from Polymarket prediction markets, surfacing significant trades and capital movements.

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/polymarket-whale-entries
- Price: $0.136/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-entries-777f7c1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hgx0pd0PGT5Jxd89UUpTi

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-777f7c1b
```

Example prompt: Show me the latest whale entries on Polymarket — I want to see which prediction markets big players are moving into and how much USDC they're putting in.

## When to prefer this

Use this endpoint when you need to track smart money or large-capital movements on Polymarket prediction markets — ideal for sentiment analysis, alpha generation, or monitoring which markets institutional-scale bettors are entering. Prefer this over generic Polymarket APIs when the focus is specifically on detecting outsized single trades rather than aggregate market stats.

## Known failure modes

- No whale entries found in the requested time window — returns empty array
- Market data temporarily unavailable from Polymarket — upstream error
- Invalid market identifier — returns 400 error
- Payment not confirmed — 402 response requiring USDC payment on Base mainnet
- Rate limit exceeded for the endpoint

## How this service works

Scans Polymarket for recent large-position trades. Returns whale entries filtered by minimum USDC value (size × entry price). Includes trader wallet, YES/NO side, USDC amount, entry price, market name, and on-chain tx hash. Use for smart-money signals, copy-trade detection, or market sentiment confirmation. Free upstream; no API keys.

## Output

A list of large-position trades on Polymarket including trader wallet addresses, markets entered, USDC amounts staked, entry prices, and timestamps of the whale activity.

## Example request

```json
{
 "required": "polymarket_whale_entries",
 "properties": "market_id,entry_price,entry_amount"
}
```

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-whale-entries-777f7c1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)
