Skip to main content
GET
Rank traders

Authorizations

x-api-key
string
header
default:<api-key>
required

API key issued by Centaur.

Query Parameters

metric
enum<string>

Ranking metric. Activity metrics: event_count (default) and position_count. Performance metrics: win_rate, avg_return, median_return, and sharpe_ratio.

Available options:
event_count,
position_count,
win_rate,
avg_return,
median_return,
sharpe_ratio
assetIds

Restrict the ranking to traders active in specific asset IDs.

direction
enum<string>

Filter to a single direction: long or short.

Available options:
long,
short
timeBasedPerformanceWindow
enum<string>

Time-based performance evaluation window for performance metrics. Defaults to 7D. Ignored for activity metrics. Positions are evaluated this long after they open, so startTime must be at least this far in the past or the request is rejected.

Available options:
1D,
7D,
30D
minPositions
integer | null

Minimum evaluated positions required for performance-metric rankings. Defaults to 3; pass 0 to include all traders. Ignored for activity metrics.

Required range: x >= 0
startTime
string<date-time>

Inclusive ISO-8601 lower time bound on position open time. Defaults to 7 days before the applied endTime. For performance metrics it must be at least the evaluation window before now.

endTime
string<date-time>

Inclusive ISO-8601 upper time bound. Defaults to the current server time.

limit
integer

Maximum number of ranked traders to return. Defaults to 10, maximum 50.

Required range: 1 <= x <= 50

Response

Bounded trader ranking for the applied metric and time window

success
enum<boolean>
required
Available options:
true
data
object
required
requestId
string
required
Example:

"c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8"

Last modified on August 21, 2026