Leaderboard

Returns a ranked list of group members based on their prediction earnings and accuracy.

Endpoint

POST/group/v1/leaderboard

Request Body

cURL

curl -X POST https://api.juspredict.com/group/v1/leaderboard \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"group_id": "group-uuid",
"page_request": { "page_number": 1, "page_size": 10 }
}'

TypeScript

{
"group_id": "group-uuid",
"page_request": { "page_number": 1, "page_size": 10 }
}

Response Body

Success 200

{
"status": { "type": "SUCCESS" },
"group_user_count": 10,
"group_user_info": [
{
  "user_info": { "first_name": "Alice" },
  "earnings": "5000",
  "accuracy": "85.5",
  "predictions": 120
}
]
}

Error 400/500

{
"status": {
"type": "ERROR",
"details": [
  {
    "code": "401",
    "message": "Unauthorized access token."
  }
]
}
}

Response Fields

Field	Type	Description
status	Status	Operation status.
user_info	UserInfo	Detailed user profile.
predictions	PredictionInfo[]	List of predictions.