> For the complete documentation index, see [llms.txt](https://hyperliquid-ohlc.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperliquid-ohlc.gitbook.io/api-docs/rest-api/trader-rank/top-traders-by-win-rate.md).

# Top Traders by Win Rate

## Get top traders by winrate on a specific token

> Returns traders ranked by total realized PnL (default) on a specific token, filtered by minimum winrate and minimum realized PnL thresholds. Supported periods: 1d, 7d, 30d, all.

```json
{"openapi":"3.1.0","info":{"title":"BlockLiquidity API Service","version":"1.0.0"},"servers":[{"url":"https://data.blockliquidity.xyz"}],"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}},"schemas":{"TopTradersByWinrateResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TopTraderByWinrate"},"type":"array","title":"Data"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["data","total"],"title":"TopTradersByWinrateResponse"},"TopTraderByWinrate":{"properties":{"address":{"type":"string","title":"Address"},"closed_trade_count":{"type":"integer","title":"Closed Trade Count"},"profit_closed_trade_count":{"type":"integer","title":"Profit Closed Trade Count"},"total_trade_count":{"type":"integer","title":"Total Trade Count"},"total_volume":{"type":"number","title":"Total Volume"},"winrate":{"type":"number","title":"Winrate"},"total_realized_pnl":{"type":"number","title":"Total Realized Pnl"}},"type":"object","required":["address","closed_trade_count","profit_closed_trade_count","total_trade_count","total_volume","winrate","total_realized_pnl"],"title":"TopTraderByWinrate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/trader/rankings/winrate":{"get":{"tags":["Trader Rankings"],"summary":"Get top traders by winrate on a specific token","description":"Returns traders ranked by total realized PnL (default) on a specific token, filtered by minimum winrate and minimum realized PnL thresholds. Supported periods: 1d, 7d, 30d, all.","operationId":"get_top_traders_by_winrate_v1_trader_rankings_winrate_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Token to filter on (e.g. BTC, ETH)","title":"Token"},"description":"Token to filter on (e.g. BTC, ETH)"},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(1d|7d|30d|all)$","description":"Time period: 1d, 7d, 30d, all","default":"7d","title":"Period"},"description":"Time period: 1d, 7d, 30d, all"},{"name":"min_winrate","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Minimum winrate threshold (0.0–1.0)","default":0.5,"title":"Min Winrate"},"description":"Minimum winrate threshold (0.0–1.0)"},{"name":"min_pnl","in":"query","required":false,"schema":{"type":"number","description":"Minimum total realized PnL threshold in USD","default":0,"title":"Min Pnl"},"description":"Minimum total realized PnL threshold in USD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of traders to return","default":50,"title":"Limit"},"description":"Number of traders to return"},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(total_realized_pnl|winrate|total_volume|closed_trade_count)$","description":"Field to sort by","default":"total_realized_pnl","title":"Sort By"},"description":"Field to sort by"},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","description":"Sort direction","default":"desc","title":"Sort Order"},"description":"Sort direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopTradersByWinrateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```