| name | challenge-ranking |
| description | Use to fetch the contestant's best score and the per-board leaderboard for the Simulation Challenge. Read-only; safe to run without confirmation. |
challenge-ranking — Best score and leaderboard
All endpoints here are read-only.
Board scoping. Best-score, rank, and leaderboard are all per-board: there is no global "total" score, and the same user can have four independent best-score / rank tuples (one per board: instruction / spatial / manip / robust). Always ask the user which board they care about, or report all four — never silently average.
Preconditions
CHALLENGE_TOKEN set for best-score (else → challenge-login).- The leaderboard endpoints (
/leaderboard, /leaderboard/top5, /leaderboard/citation) are public — they work without a token, but include Authorization when you have one to stay symmetric with the rest of the skill set.
Every Bash call should start with:
[ -f ~/.simubotix-challenge.env ] && . ~/.simubotix-challenge.env
My best score and rank (per board)
best-score requires a board query parameter (it filters the user's per-board best):
[ -f ~/.simubotix-challenge.env ] && . ~/.simubotix-challenge.env
curl -fsS "$BASE_URL/api/challenge/best-score?board=instruction" \
-H "Authorization: Bearer $CHALLENGE_TOKEN" | jq
