API ReferencePerformance & Leaderboard
Live

Performance & Leaderboard

Aggregate trading stats for a single wallet, and a ranked board of the best wallets over a window. Both are computed from realized PnL.

Wallet performance

L2   GET /v1/wallet/{address}/performance

ParameterTypeDefaultDescription
windowstring7d1d · 7d · 30d
FieldTypeDescription
total_tradesnumberClosed trades in the window
wins / lossesnumberProfitable / unprofitable count
win_ratenumberwins / total_trades (0–1)
total_pnl_usdnumberRealized PnL
cash_pnl_usdnumberActual SOL/cash returned (realized, fees in)
total_volume_usdnumberTraded volume
total_fees_usdnumberFees paid
avg_hold_time_secondsnumberAverage hold
sharpe_rationumberRisk-adjusted return proxy
profit_factornumberGross profit / gross loss
disposition_indexnumberHold-on-winners vs hold-on-losers
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/wallet/7xKXtg.../performance?window=7d"
⚠️

win_rate here is the per-exit (commodity) rate — a DCA-out over N sells counts as N wins. For a position-correct skill read that corrects this distortion, use Wallet Quality.

Leaderboard

L2   GET /v1/leaderboard

Ranks wallets with at least 5 completed trades over the window.

ParameterTypeDefaultDescription
windowstring7d1d · 7d · 30d
sortstringpnl_usdpnl_usd · roi · win_rate
limitinteger100Max rows (max 500)
offsetinteger0Pagination offset
SortRanks byBest for
pnl_usdTotal realized PnL (USD)Biggest absolute winners
roiReturn on entry volume (%)Efficient traders regardless of size
win_rateWin/loss ratioConsistency
curl -H "Authorization: Bearer $API_KEY" \
  "https://api.conyr.ai/v1/leaderboard?window=1d&sort=roi&limit=10"
{
  "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": "pnl_usd", "limit": 25, "offset": 0
}

The 5-trade minimum keeps one-hit wonders off the board. roi is total_pnl_usd / total_entry_volume × 100. Cached 60s.