Get Trading Competition

Settings, status and prize table of one competition: its markets and boosts (also for upcoming competitions), the qualification minimum, the market the "Start Trading" button opens (the boosted market with the most 24-hour volume, else the top market overall), and when the leaderboard was last updated.

Score is PnL × √(boosted volume). PnL counts realized and (when count_unrealized) unrealized PnL on positions opened during the competition, after fees and funding. Boosts multiply volume only.

get/v1/info/competition

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/info/competition
  • Auth: none required

Query parameters

competition_idinteger required

Trading competition ID

Example:3

Response

Competition detail.

competition_idinteger required

Trading competition ID

numberinteger required
namestring required
sector_labelstring required
boost_descriptionstring required
status'upcoming' | 'live' | 'in_review' | 'ended' required

Competition lifecycle status. upcoming before start, live while running, in_review from the end until every prize is paid (ranks can still change after disqualifications), ended once results are final and every prize is paid.

start_timeinteger required
end_timeinteger required
all_marketsboolean required

Every perpetual counts, including markets listed during the competition. When false only markets count.

min_volumestring required

Unboosted notional volume needed to rank, as a numeric string

count_unrealizedboolean required

Whether unrealized PnL on open qualifying positions counts

prize_poolstring required
prize_asset_idinteger required
paid_placesinteger required

Size of the prize zone (ranks 1 to paid_places)

internalboolean required
start_trading_instrument_idinteger

Instrument ID

updated_atinteger

Update timestamp in milliseconds

rankedinteger required

Accounts on the leaderboard (qualified)

participantsinteger required

Accounts with at least one counted fill

prize_cutoff_scorestring

Competition score, PnL × √(boosted volume), as a numeric string rounded to 6 decimal places. Can be negative.

final_resultsboolean required

The leaderboard shows frozen end-of-competition results

scoring_versioninteger required

Example response

{
  "competition_id": 3,
  "markets": [
    {
      "boost": "3"
    }
  ],
  "min_volume": "100000",
  "prize_tiers": [
    {
      "amount": "10000"
    }
  ],
  "updated_at": 1767225600000,
  "prize_cutoff_score": "1264911.064067"
}

Changes

No operation changes recorded.