Get Trading Competition Account

One account's standing: rank and score once qualified, otherwise its volume so far and how much more it needs to rank; projected or won prize; places and score from the prize zone; every position it held when the competition started, by market, and whether it has since been closed. An address with no activity returns zero figures and no rank.

get/v1/info/competition/account

Request

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

Query parameters

competition_idinteger required

Trading competition ID

Example:3
addressstring required

Address

Example:0x1234567890abcdef1234567890abcdef12345678

Response

Account standing.

competition_idinteger required

Trading competition ID

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.

updated_atinteger

Update timestamp in milliseconds

accountstring required

Account address in hex format

rankinteger

Leaderboard rank under the requested ranking metric, starting at 1

qualifiedboolean required

Reached the minimum volume and is ranked

scorestring required

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

pnlstring required
realized_pnlstring required
unrealized_pnlstring required
feesstring required

Fees paid net of rebates

fundingstring required

Funding received net of funding paid

volumestring required
boosted_volumestring required
min_volumestring required
volume_to_qualifystring required

Unboosted volume still needed to rank; "0" once qualified

qualification_progressstring required

Fraction of the minimum reached, from "0" to "1"

prizestring
spots_from_prize_zoneinteger

Places between this rank and the last paid place; 0 inside the prize zone; absent when unranked

score_to_prize_zonestring

Score still needed to reach the prize zone; "0" inside it; absent when unranked

row_state'live' | 'provisional' | 'disqualified' | 'final' | 'paid' required

How a leaderboard row is shown. live while running (prize is projected), provisional while in review, disqualified for a rule violation, final once results are finalized, paid once the prize is paid.

payout_tx_hashstring
paid_atinteger

Example response

{
  "competition_id": 3,
  "updated_at": 1767225600000,
  "account": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "rank": 1,
  "score": "1264911.064067"
}

Changes

No operation changes recorded.