Trader rankings & risk metrics.

Rank and filter traders#

Request advanced=true to include the advanced metrics object when available. Rankings represent a snapshot; display updatedAt alongside your results.

curl --fail-with-body \
  "${IMPLYRA_API_URL%/}/leaderboard/global?advanced=true&sortBy=sharpe&sortOrder=DESC&minPositions=50&limit=20"

advancedboolean

Include the optional advanced metrics object.

sortBy / sortOrderquery

Common sort fields: pnl, realized_pnl, win_rate, volume, sharpe, sortino, calmar, max_drawdown, roi and smart_score. pnl sorts total P&L; realized_pnl sorts realized P&L. Order is ASC or DESC; lower drawdown requires ASC.

minPnl / maxPnlrealized P&L · USD

These filters use the backend realized-P&L field, not the overallPnl headline (realized plus unrealized). A result can meet a realized-P&L threshold while showing a different overallPnl. Realized-history completeness is not established by this filter.

minVolume / maxVolumeUSD

Filter by recorded total trading volume.

minPositions / maxPositionsinteger

Filter by the recorded position count. Combine sample size with performance rather than treating a high ratio in isolation.

minWinRate / maxWinRate0–1

Filter the ratio of winning closed positions. A value of 0.6 corresponds to 60%.

isActiveboolean

Restrict the snapshot by the recorded active classification.

limit / cursor / offsetpagination

Limit defaults to 100 and accepts 1–1000. Pass nextCursor as cursor for the next page, keeping filters and sort unchanged. Offset is also supported.

Read the measures correctly#

overallPnlUSD

Realized plus unrealized P&L.

winRate / totalClosedPositions0–1 / count

The closed-position win rate and its reported sample size.

advanced.sharpeRatio / sortinoRatio / calmarRationumber | null

Risk-adjusted measures calculated from the available cumulative P&L history. These describe P&L changes, not cash-flow-adjusted account returns. Current calculations clamp these ratios to −10…10.

advanced.maxDrawdown0–1 | null

Peak-to-trough decline relative to cumulative P&L gains, with a $1 minimum denominator and a 0–1 clamp. Multiply by 100 to display percent. It is not an account-equity drawdown.

advanced.winRateWeighted0–1 | null

Bought volume in profitable closed positions divided by bought volume across closed and active positions. Both volumes sum total_bought. This is not a conventional weighted win rate calculated only from closed positions; open positions also contribute to the denominator.

advanced.roiratio | null

A backend return ratio. Multiply by 100 for percent and keep the underlying coverage visible; do not present it as an annualized return.

advanced.smartScore / confidenceScore0–100 | null

Smart score is a composite heuristic. Confidence score reflects sample size and trading volume, not confidence that a future prediction will be correct.

advanced.bestTag / lastTradeAt / isActivecontext

The category and activity context from the advanced-metrics dataset. lastTradeAt is its last observed trade, not a guarantee that the full trader record is current.

Use a typed response#

Download the OpenAPI file, generate types, then reference the response type directly. TypeScript describes the contract; it does not validate arbitrary JSON at runtime.

pnpm dlx openapi-typescript implyra-openapi.json -o src/types/implyra.ts

Continue into the portfolio#

Use rows[].address to open a profile and inspect positions. A ranking identifies a record to research; the portfolio and history provide the next layer of context.