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

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"

Python Example

import requests
 
resp = requests.get(
    "https://api.conyr.ai/v1/leaderboard",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"window": "7d", "sort": "pnl_usd", "limit": 25},
)
 
for entry in resp.json()["leaderboard"]:
    print(f"#{entry['rank']} {entry['wallet_address'][:8]}... "
          f"PnL: ${entry['total_pnl_usd']:,.2f} "
          f"ROI: {entry['roi']:.1f}% "
          f"Win: {entry['win_rate']:.0%}")

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 minimum trade threshold (5 trades) prevents one-hit wonders from dominating the board
The leaderboard is cached for 60 seconds
roi is calculated as total_pnl_usd / total_entry_volume * 100

Wallets (Legacy)Taxonomy