# Get trader leaderboard

GET /api/v1/market-data/leaderboard

## Get trader leaderboard

> Returns a global ranking of traders sorted by realised PnL, win rate, or volume for a given time period. Pass a \`user\` wallet address to retrieve a single wallet's rank within the leaderboard.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/leaderboard","name":"get-trader-leaderboard"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/leaderboard":{"get":{"description":"Returns a global ranking of traders sorted by realised PnL, win rate, or volume for a given time period. Pass a `user` wallet address to retrieve a single wallet's rank within the leaderboard.","tags":["get-trader-leaderboard"],"summary":"Get trader leaderboard","parameters":[{"schema":{"type":"string","default":"all","enum":["1d","7d","30d","all"]},"description":"Time period","name":"period","in":"query"},{"schema":{"type":"string","default":"pnl","enum":["pnl","win_rate","volume"]},"description":"Sort criterion","name":"sort_by","in":"query"},{"schema":{"type":"string"},"description":"Wallet address — returns that wallet's rank instead of the full list","name":"user","in":"query"},{"schema":{"type":"integer","default":100,"maximum":500,"minimum":1},"description":"Max results","name":"limit","in":"query"},{"schema":{"type":"integer","default":0},"description":"Pagination offset","name":"offset","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.PaginatedResponse-handler_LeaderboardEntry"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"api.PaginatedResponse-handler_LeaderboardEntry":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.LeaderboardEntry"}},"pagination":{"$ref":"#/components/schemas/api.Pagination"}}},"handler.LeaderboardEntry":{"type":"object","properties":{"losingPredictions":{"type":"integer"},"losingSells":{"type":"integer"},"pnl":{"type":"number"},"pnlPct":{"type":"number"},"profitableSells":{"type":"integer"},"rank":{"type":"integer"},"totalVolume":{"type":"number"},"tradeCount":{"type":"integer"},"walletAddress":{"type":"string"},"winRate":{"type":"number"},"winningPredictions":{"type":"integer"}}},"api.Pagination":{"type":"object","properties":{"hasMore":{"type":"boolean"},"totalResults":{"type":"integer"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```