List the biggest wins

The biggest single winning positions.

One row per winning POSITION, not per user: pnl is final_value - initial_value for that position, and the window (?time_period=, default day) is on when it resolved. ?category= narrows to a market category. Deeper pages come only from ?cursor=, which pins the window and category it was minted on; restating a different one is a 400, not a silent re-point.

Combo wins are first-class rows here, tagged kind = "combo". They carry a ' / '-joined title of their legs and no Gamma event; event_id is 0 and event_slug empty; so branch on kind before building an event link.

GET /v2/biggest-winners

List the biggest wins

cURL

curl --request GET \
  --url https://data-api.polymarket.com/v2/biggest-winners \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "condition_id": "<string>",
      "event_id": 123,
      "event_slug": "<string>",
      "event_title": "<string>",
      "final_value": 123,
      "initial_value": 123,
      "kind": "<string>",
      "pnl": 123,
      "position_id": "<string>",
      "profile_image": "<string>",
      "resolved_at": 123,
      "user_id": "<string>",
      "user_name": "<string>",
      "win_rank": 1
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 1,
    "offset": 1,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

time_period · string | null

Window on resolved_at: day | week | month | all. Defaults to day.

category · string | null

overall (default), a Gamma market category (e.g. sports), or a synthetic category: combos (combinatorial wins get their own full top-500 per window) or esports (promoted subcategory).

limit · integer<int32> | null

First-page size. Ignored when cursor is supplied.

Required range: 0 <= x <= 1000

cursor · string | null

Opaque pagination cursor from a prior response's next_cursor.

Response

200

application/json

A page of the biggest winning positions

{ data, pagination } envelope for /v2/biggest-winners.

data · object[] · required

The page's rows.

Show child attributes

pagination · object · required

Paging envelope: follow next_cursor until null.

Show child attributes