Get Trading Competition Widget

The live competition at a glance for the trading page: when it ends, and, with address, that account's rank and progress toward the qualification minimum. Designed to be polled; it reads only the published standings. Without a live competition only timestamp is set.

get/v1/info/competition/widget

Request

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

Query parameters

addressstring

Address

Example:0x1234567890abcdef1234567890abcdef12345678

Response

Live competition widget.

timestampinteger required

Update timestamp in milliseconds

competition_idinteger

Trading competition ID

numberinteger
end_timeinteger
rankinteger

Leaderboard rank under the requested ranking metric, starting at 1

qualifiedboolean
volumestring
min_volumestring
qualification_progressstring
spots_from_prize_zoneinteger
updated_atinteger

Update timestamp in milliseconds

Example response

{
  "timestamp": 1767225600000,
  "competition_id": 3,
  "rank": 1,
  "updated_at": 1767225600000
}

Changes

No operation changes recorded.