speedrun_game_leaderboard
Retrieve a full-game speedrun leaderboard with native placements, tied runs, and game, category, and level context. Use it to fetch ranked runs by game and category with optional filters.
Instructions
Get a Speedrun full-game leaderboard. Returns native places, tied runs and game/category/level context. top counts places, not runs. IDs come from game/category/level discovery; platform/region use catalog discovery. Game variables expose value IDs and scope; requested variables are checked against this board's native applicable-variable embedding. No local ranking or synthetic pagination is performed.
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": {
"game": "<game>",
"category": "<category>"
},
"name": "speedrun_game_leaderboard"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Top places, 1–200; API response-budget limit, ties can return more runs | |
| date | No | Run date cutoff YYYY-MM-DD | |
| game | Yes | Native game ID | |
| embed | No | Native metadata embeds | |
| region | No | Native region ID from catalogs | |
| timing | No | Native timing method; omission uses source default | |
| category | Yes | Native category ID appropriate to this board | |
| platform | No | Native platform ID from catalogs | |
| emulators | No | Omit for both; true for emulators, false for real devices | |
| variables | No | JSON object mapping native variable IDs to value IDs | |
| video_only | No | Require a video when true; omission uses source default |