Skip to main content
GET
/
v1
/
biggest-winners
Get biggest winners
curl --request GET \
  --url https://data-api.kuest.com/v1/biggest-winners
[
  {
    "winRank": "1",
    "proxyWallet": "0x1234567890abcdef1234567890abcdef12345678",
    "userName": "Theo4",
    "eventTitle": "Popular Vote Winner 2024",
    "slug": "popular-vote-winner-2024",
    "icon": "https://cdn.kuest.com/markets/popular-vote.png",
    "eventSlug": "presidential-election-2024",
    "initialValue": 8499002,
    "finalValue": 22862194,
    "pnl": 14363192,
    "profileImage": "https://cdn.kuest.com/profiles/theo4.png"
  }
]
https://data-api.kuest.com/v1/biggest-winners lists the largest realized wins from closed positions, with category filters and pagination.

​
Query parameters

  • category: Category filter (OVERALL, POLITICS, SPORTS, CRYPTO, FINANCE, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH).
  • timePeriod: Time window (DAY, WEEK, MONTH, ALL).
  • limit: Max rows (1-50, default 20).
  • offset: Pagination (0-1000).

​
Campos relevantes

  • winRank: Rank within the filtered results.
  • eventTitle: Event title.
  • initialValue: Estimated cost basis for the position.
  • finalValue: Returned value (initialValue + pnl).
  • pnl: Realized profit for the position.
  • slug e icon: Dados do mercado para renderizar no frontend.

Query Parameters

​
category
enum<string>
default:OVERALL

Category filter.

Available options:
OVERALL,
POLITICS,
SPORTS,
CRYPTO,
FINANCE,
CULTURE,
MENTIONS,
WEATHER,
ECONOMICS,
TECH
​
timePeriod
enum<string>
default:DAY

Time window for aggregation.

Available options:
DAY,
WEEK,
MONTH,
ALL
​
limit
integer
default:20

Maximum number of rows to return.

Required range: 1 <= x <= 50
​
offset
integer
default:0

Starting index for pagination.

Required range: 0 <= x <= 1000

Response

Biggest wins returned.

​
winRank
string
​
proxyWallet
string

0x-prefixed EVM address (40 hex chars).

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
userName
string | null
​
eventTitle
string | null
​
slug
string | null
​
icon
string | null
​
eventSlug
string | null
​
initialValue
number
​
finalValue
number
​
pnl
number
​
profileImage
string | null