Ranking Builder

The Builder (polyrank.app/rankings/builder, paid plans) lets you weight any combination of catalog metrics into a custom composite and rank the full wallet universe against it.

Drag a weight slider and the live preview re-ranks the 2.9M-wallet universe — the top-20 column updates as you compose.

Via API

curl -s -X POST https://api.polyrank.app/v1/rankings/custom \
  -H "Authorization: Bearer pk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "weights": { "brier_score": 0.4, "alpha_vs_mid": 0.3, "sharpe": 0.3 },
    "filters": { "min_trades": 100, "min_volume_usdc": 10000 },
    "limit": 50
  }'

• Weights apply to percentile-normalized metric values; direction (higher/lower-is-better) is handled per the catalog.
• Filters cut the universe before ranking — sample-size floors keep small-N noise out. Beyond the fixed gates, metric_filters puts an absolute min/max on ANY displayable metric's raw lifetime value ({"metric_filters": [{"metric": "copier_realized_return", "min": 0}]}, max 12; wallets where the metric isn't measured are excluded), and skill_gates is the relative version (top-X% by percentile, max 8).
• Sorting: sort_by accepts composite (default), a raw stat (realized_pnl, roi_pct, win_rate_pct, lifetime_volume_usdc, trade_count, copier_realized_return), or any displayable metric via metric:<id> (raw lifetime value) / pctile:<id> (lifetime percentile, direction-corrected so desc is always best-first). Unmeasured values always sort last.
• na_policy controls wallets missing a weighted metric: exclude (default — only fully-measured wallets qualify) or neutral_50 (missing metrics score a neutral 50th percentile instead).
• Full config schema: API Reference → Rankings.

Reading the breakdown (the measured marker)

Set include_breakdown: true and each ranking row carries a breakdown object — the per-metric percentile that fed the composite. Two response fields work together:

Recipes to start from