# 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"}},"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"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperliquid-ohlc.gitbook.io/api-docs/rest-api/trader-rank/top-traders-by-win-rate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.