List Polymarket leaderboard
polymarket_leaderboard_listList Polymarket's leaderboard ranked by profit or volume across day, week, month, or all-time windows, filtered by category. Look up a specific wallet's rank instead of the full board.
Instructions
List Polymarket's leaderboard by profit or volume, by window and category. Optional inputs: window, category, sortBy, wallet, limit and 1 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "polymarket_leaderboard_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page, 1–1000. Default: 100. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same. | |
| sortBy | No | Rank by profit (`pnl`, default) or traded volume (`volume`). | |
| wallet | No | Return this wallet's rank instead of the board: one row with `rankPnl` and `rankVolume`. A wallet that is not on the board for this window and category returns an empty list. | |
| window | No | Time window. Default: `all`. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| category | No | Only this category, for example `sports`, `crypto` or `politics`. An unknown category returns an empty list. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |