> 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-metrics/trader-win-rate.md).

# Trader Win Rate

## Get win rate for a specific trader

> Returns overall win rate and per-token breakdown for a wallet address.\
> \
> Each entry includes trade count, closed trades, profitable trades, volume, realized PnL, and win rate.\
> \
> \`win\_rate\` is a percentage (e.g. \`65.00\` = 65%).\
> \
> Supported periods:\
> \- \`1d\` → last 24 hours\
> \- \`7d\` → last 7 days\
> \- \`30d\` → last 30 days\
> \- \`1y\` → last 1 year\
> \- \`all\` → all-time (default)\
> \
> Optionally filter by a specific token (e.g. \`BTC\`, \`HYPE\`).

```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":{"TraderWinRateResponse":{"properties":{"address":{"type":"string","title":"Address"},"period":{"type":"string","title":"Period"},"overall":{"$ref":"#/components/schemas/TraderWinRateEntry"},"tokens":{"items":{"$ref":"#/components/schemas/TraderWinRateEntry"},"type":"array","title":"Tokens"}},"type":"object","required":["address","period","overall","tokens"],"title":"TraderWinRateResponse"},"TraderWinRateEntry":{"properties":{"token":{"type":"string","title":"Token"},"total_trades":{"type":"integer","title":"Total Trades","default":0},"closed_trades":{"type":"integer","title":"Closed Trades","default":0},"profit_closed_trades":{"type":"integer","title":"Profit Closed Trades","default":0},"vlm":{"type":"number","title":"Vlm","default":0},"realized_pnl":{"type":"number","title":"Realized Pnl","default":0},"win_rate":{"type":"number","title":"Win Rate","default":0}},"type":"object","required":["token"],"title":"TraderWinRateEntry"},"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/{address}/winrate":{"get":{"tags":["Trader Rankings"],"summary":"Get win rate for a specific trader","description":"Returns overall win rate and per-token breakdown for a wallet address.\n\nEach entry includes trade count, closed trades, profitable trades, volume, realized PnL, and win rate.\n\n`win_rate` is a percentage (e.g. `65.00` = 65%).\n\nSupported periods:\n- `1d` → last 24 hours\n- `7d` → last 7 days\n- `30d` → last 30 days\n- `1y` → last 1 year\n- `all` → all-time (default)\n\nOptionally filter by a specific token (e.g. `BTC`, `HYPE`).","operationId":"get_trader_winrate_v1_trader__address__winrate_get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","description":"Trader wallet address","title":"Address"},"description":"Trader wallet address"},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(1d|7d|30d|1y|all)$","description":"Time period: 1d, 7d, 30d, 1y, all","default":"all","title":"Period"},"description":"Time period: 1d, 7d, 30d, 1y, all"},{"name":"token","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by token (e.g. BTC, HYPE)","title":"Token"},"description":"Filter by token (e.g. BTC, HYPE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TraderWinRateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```