DevelopersDocumentation
OpenAPI
API referenceTrader analytics

Trader rankings & risk metrics.

Find traders by performance and activity. Inspect the risk metrics behind a track record.

On this page

Rank and filter traders

GET/leaderboard/globalREST

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

Rank a larger sample by Sharpe ratio
cURL
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.

i
Preserve the reporting context

Advanced metrics can cover an older or different period from the overall leaderboard P&L. A recent ranking updatedAt does not mean each advanced field was recomputed then. Keep their available history and lastTradeAt visible. Fields may be null, and the source can emit zero for insufficient history; neither establishes low risk.

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.

Typed trader ranking
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.

Implyra.Trader intelligence, ready to build.
to navigate to openesc to close