Polymarket

List Polymarket biggest wins

List the largest winning positions on Polymarket by window and category.

GET/v1/polymarket/biggest-wins
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
windowstringquery

Time window. Default: `all`.

one of: day, week, month, all

categorystringquery

Only this category, for example `sports`, `crypto` or `politics`. An unknown category returns an empty list.

pattern: ^[a-z0-9][a-z0-9_-]{0,40}$

limitintegerquery

Items per page, 1–500. Default: 100.

≥ 1 · ≤ 500

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same.

min 1 chars · max 6000 chars

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

`found` on success.

one of: found, not_found

Largest first.

datawins[]rank
integernullable

Position among wins, 1 is best.

datawins[]kind
stringnullable

What the win came from, for example `market`.

datawins[]wallet
string

Wallet address.

datawins[]name
stringnullable

Chosen username or auto-generated name.

datawins[]image
stringnullable

Profile image URL.

datawins[]pnl

Profit in US dollars. A number, or an exact decimal string when the value has more digits than a number can hold.

datawins[]initialValue

Dollars the position started with. A number, or an exact decimal string when the value has more digits than a number can hold.

datawins[]finalValue

Dollars the position ended with. A number, or an exact decimal string when the value has more digits than a number can hold.

datawins[]resolvedAt
stringnullable

When the market resolved (ISO-8601, UTC).

datawins[]conditionId
stringnullable

Condition id of the market.

datawins[]positionId
stringnullable

Outcome token id of the winning position.

datawins[]eventId
stringnullable

Event id.

datawins[]eventSlug
stringnullable

Event slug.

datawins[]eventTitle
stringnullable

Event title.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/polymarket/biggest-wins?window=month&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Polymarket biggest wins.