Skip to main content
curl --request GET \
  --url 'https://api.longshot.xyz/v1/contests/550e8400-e29b-41d4-a716-446655440000/top-participants?limit=5'

{
  "window_ms": 604800000,
  "participants": [
    {
      "user_id": "11111111-1111-1111-1111-111111111111",
      "handle": "alice",
      "x_handle": "alice",
      "x_avatar_url": null,
      "avatar_seed": 12345,
      "won_count": 3,
      "total_winnings_micros": 12500000
    }
  ]
}

curl --request GET \
  --url 'https://api.longshot.xyz/v1/contests/550e8400-e29b-41d4-a716-446655440000/top-participants?limit=5'

{
  "window_ms": 604800000,
  "participants": [
    {
      "user_id": "11111111-1111-1111-1111-111111111111",
      "handle": "alice",
      "x_handle": "alice",
      "x_avatar_url": null,
      "avatar_seed": 12345,
      "won_count": 3,
      "total_winnings_micros": 12500000
    }
  ]
}

​
Endpoint

GEThttps://api.longshot.xyz/v1/contests/{id}/top-participants
GET https://api.longshot.xyz/v1/contests/{id}/top-participants
Returns entrants of this contest ranked by their contest payouts over the requested lookback window. This community-insights endpoint is available for lineups and outcast contests; survivor and streak contests return 404 CONTEST_NOT_FOUND.

​
Path Parameters

​
id
uuid
required
Contest ID returned by GET /v1/contests.

​
Query Parameters

​
window_ms
int64
Lookback window in milliseconds. Defaults to 604800000 for 7 days.
​
limit
int32
Maximum rows to return. Defaults to 5; the server clamps to 1..=25.

​
Response Fields

​
window_ms
int64
Applied lookback window in milliseconds.
​
participants
array
Entrants ranked by contest winnings in the requested window.
​
participants[].user_id
uuid
Participant user ID.
​
participants[].handle
string | null
Longshot handle when the user has one.
​
participants[].x_handle
string | null
Linked X handle when available.
​
participants[].x_avatar_url
string | null
Linked X avatar URL when available.
​
participants[].avatar_seed
int32
Deterministic seed for generated avatar rendering.
​
participants[].won_count
int32
Number of contests won in the requested window.
​
participants[].total_winnings_micros
int64
Total contest winnings in micros over the requested window.