> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/polymarket/biggest-wins>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/polymarket/biggest-wins.mdx>

---

# Polymarket Biggest Wins API

The largest winning positions, with profit and the event behind each one.

`GET /v1/polymarket/biggest-wins` returns `data.wins`, largest first. Each row has `rank`, `kind`, `wallet`, `name`, `image`, `pnl`, `initialValue`, `finalValue`, `resolvedAt`, `conditionId`, `positionId`, `eventId`, `eventSlug` and `eventTitle`. `window` is `day`, `week`, `month` or `all` and defaults to `all`; `category` narrows to a category such as `sports`.

`limit` is 1 to 500 and defaults to 100. The board holds 500 wins, so a larger page would come back with 500 anyway. `data.page` continues with a cursor. `positionId` is the outcome token id of the winning position.

## Request

- **Endpoint:** `GET /v1/polymarket/biggest-wins`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by window or category
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/polymarket/biggest-wins/get)
- **Platform page:** [/platforms/polymarket](https://www.socialfetch.dev/platforms/polymarket)

## FAQ

### What is positionId?

The outcome token id of the winning position. You can pass it to the token price history route to see the price path, or use conditionId with the market routes to see the market.

### Why is the limit capped at 500?

The board holds 500 wins. A larger limit would silently return 500, so the route caps it. Use the window and category filters to look at a narrower slice.

### Is a win the same as profit?

pnl is the profit on the position, while initialValue and finalValue show the dollars in and out. A position can have a large final value and a modest profit, so read all three.

### What does lookupStatus mean on this route?

found means the object or list was returned. not_found means no matching object exists. HTTP 200 only means the request finished, so branch on data.lookupStatus before storing a row.

### How much does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.