Leaderboard

The leaderboard ranks wallets by trading performance over a given time window. Only wallets with at least 5 completed trades are included.

GET /v1/leaderboard

Parameters

Parameter	Type	Default	Description
`window` (query)	string	`7d`	Time window: `1d`, `7d`, or `30d`
`sort` (query)	string	`pnl_usd`	Sort metric: `pnl_usd`, `roi`, or `win_rate`
`limit` (query)	integer	`100`	Results per page (max 500)
`offset` (query)	integer	`0`	Pagination offset
`include_hft` (query)	boolean	`false`	When `false` (default), excludes wallets with a median hold time under 60 seconds (HFT/MEV bots) so the board reflects real traders. Set `true` to include them.

Example

# Top 10 wallets by ROI in the last 24 hours
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/leaderboard?window=1d&sort=roi&limit=10"

Response

{
  "leaderboard": [
    {
      "rank": 1,
      "wallet_address": "7xKXtg...",
      "total_trades": 342,
      "wins": 245,
      "losses": 97,
      "win_rate": 0.7163,
      "total_pnl_usd": 89420.50,
      "total_volume_usd": 456000.00,
      "roi": 19.6,
      "cash_pnl_usd": 78200.00
    }
  ],
  "window": "7d",
  "sort": "total_pnl_usd",
  "limit": 25,
  "offset": 0
}

Sort Options

Value	Ranked By	Best For
`pnl_usd`	Total realized PnL in USD	Finding the biggest absolute winners
`roi`	Return on investment (%)	Finding efficient traders regardless of size
`win_rate`	Win/loss ratio	Finding consistent traders

Notes

The leaderboard is cached for 60 seconds.

The minimum trade threshold (5 trades) prevents one-hit wonders from dominating the board
roi is calculated as total_pnl_usd / total_entry_volume * 100

Wallets Taxonomy