API ReferenceAdvanced Order TypesCopy Trading

Ranked leaders to copy (skill-based, ML-28)

Return copy-trade leaders ranked by risk-adjusted skill (ML-28). Read-only, optional-auth (public leaderboard-style). Behind ``ML_LEADER_RANKING_ENABLED``: when on, ``sort`` defaults to ``skill`` (raw ``pnl`` is preserved as an option); when off, the ordering is unchanged raw PnL regardless of ``sort``. Provisional leaders (below ``ML_LEADER_MIN_RESOLVED`` resolved markets) are labelled and never top-ranked. Each entry carries ``rank_reasons`` (machine codes) that the frontend maps to explanation chips.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-API-Keystring or nullOptional

Query parameters

sortstring or nullOptionalformat: "^(skill|pnl)$"

Ordering: ‘skill’ (risk-adjusted, default when ranking is enabled) or ‘pnl’ (raw profit). When ranking is disabled the order is always raw PnL.

limitintegerOptional1-100Defaults to 20

Response

Successful Response
leaderslist of objects
min_resolvedinteger

Resolved-market gate below which a leader is provisional

ranking_enabledboolean

Whether ML_LEADER_RANKING_ENABLED is on (skill ordering available)

sortstring

Ordering applied: ‘skill’ or ‘pnl’

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error