Trader leaderboard

Changed on Oct 2, 2026

Ranked traders. period=allTime reads the all-time traders table. day/week/month aggregate trader_daily_stats over UTC calendar days (a fill at 23:59 counts for its whole day). minTrades (default 10) applies before ranking in every supported sort. score and risk-adjusted are unsupported and return 400. winRate is the percentage of all fills with positive closed PnL, not a position win rate. PnL is gross of fees. totalFees, largestWin, largestLoss, firstTradeAt and lastTradeAt are all-time facts the period aggregate does not compute, so period rows carry null for them. total is the number of rows returned. Spot pairs are not excluded, so a spot market maker can top the pnl and volume sorts.

get/api/public/v1/pulse/leaderboard

Request

Base URL
https://api.coinversa.ai
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/coinversa/apis/coinversa-api/docs/api/public/v1/pulse/leaderboard/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

period'allTime' | 'day' | 'week' | 'month'

limitinteger

minTradesinteger

Response

$schemastring uri

A URL to the JSON Schema for this object.

totalinteger required

Number of rows in traders.

Example response

{
  "$schema": "https://api.coinversa.ai/schemas/LeaderboardBody.json",
  "traders": [
    {
      "$schema": "https://api.coinversa.ai/schemas/LeaderboardTrader.json"
    }
  ]
}

Changes

Oct 2, 202618a9902cb107 Revision changes
- warning
  for the query request parameter limit, the max was set to 100.00
- warning
  for the query request parameter limit, the min was set to 1.00
- info
  added the new optional query request parameter minTrades
Sep 23, 2026f2eba29805e5 Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history