API reference · v5

Bybit Leaderboard API

Bybit's trading leaderboard: the daily top 500 or the latest weekly, bi-weekly and monthly editions, with each trader's profile, chart and open positions.

Base URL https://api.kopyon.com/v5/bybit-leaderboard/ · send your key in the X-API-KEY header · trader id: The hash_id in a trader's Bybit profile URL.

Get a free API key · Interactive reference with Try it · Authentication, paging and errors

Traders

GET /v5/bybit-leaderboard/traders

Bybit's daily top 500 by PnL over a period; or, with edition, the top 50 of its latest weekly, bi-weekly or monthly edition.

Bybit refreshes this Bybit updates the daily top 500 once a day, and each edition when it closes..

Query parameters

Name	Type	Description
`period`required	enum	1D is yesterday1D, 7D, 30D, 90D
`market`	enumdefault derivatives	Derivatives only, or all trading productsderivatives, all
`group`	enumdefault all	All traders, or Bybit's master tradersall, master
`sharingPositions`	bool	true lists only traders who share their positions
`edition`	enum	The top 50 of Bybit's latest weekly, bi-weekly or monthly edition instead; the other filters are then ignoredweek, biWeek, month
`page`	intdefault 1	Page number
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`traders[]`always	array
`traders[].traderId`always	string	The trader's id at the source; other operations take it as traderId
`traders[].name`always	string	Display name
`traders[].avatarUrl`	string
`traders[].roi`	number
`traders[].pnl`	number
`traders[].pnlCurrency`	string
`traders[].sourceDetails.followers`	only Bybit
`traders[].sourceDetails.sharingPositions`	only Bybit
`traders[].sourceDetails.editions`	only Bybit
`traders[].sourceDetails.winningDays`	only Bybit
`traders[].sourceDetails.trades`	only Bybit
`traders[].rank`	number
`hasMore`always	boolean	true when another page follows
`total`always	number
`startTime`	number	With edition: when it began, in Unix milliseconds
`endTime`	number	With edition: when it ended, in Unix milliseconds

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bybit-leaderboard/traders?period=1D"

{
  "data": {
    "traders": [
      {
        "traderId": "6LBl1dpjnE91knEy",
        "name": "Nev***",
        "rank": 1,
        "pnl": 1801620.86,
        "pnlCurrency": "USD",
        "sourceDetails": {
          "followers": 0,
          "sharingPositions": false,
          "editions": {
            "weekly": 28,
            "biweekly": 18,
            "monthly": 12
          },
          "winningDays": 1,
          "trades": 2640
        }
      },
      {
        "traderId": "y2PO1bR7dBgR1bEa",
        "name": "lyl****@****",
        "rank": 2,
        "pnl": 358640.37,
        "pnlCurrency": "USD",
        "sourceDetails": {
          "followers": 0,
          "sharingPositions": false,
          "editions": {
            "weekly": 0,
            "biweekly": 0,
            "monthly": 0
          },
          "winningDays": 1,
          "trades": 20
        }
      },
      {
        "traderId": "79exDaxx8a9lKrN0",
        "name": "lyy****@****",
        "rank": 3,
        "pnl": 202435.99,
        "pnlCurrency": "USD",
        "sourceDetails": {
          "followers": 0,
          "sharingPositions": false,
          "editions": {
            "weekly": 0,
            "biweekly": 0,
            "monthly": 0
          },
          "winningDays": 1,
          "trades": 60
        }
      }
    ],
    "hasMore": true,
    "total": 500
  }
}

Search traders

GET /v5/bybit-leaderboard/traderSearch

Traders in the daily top 500 whose name contains this, by 90-day derivatives PnL.

Query parameters

Name	Type	Description
`name`required	string	Part of the trader's name
`page`	intdefault 1	Page number
`rows`	intdefault 20	Rows per page1 to 20

Response fields, in `data`

Field	Type	Description
`traders[]`always	array
`traders[].traderId`always	string	The trader's id at the source; other operations take it as traderId
`traders[].name`always	string	Display name
`traders[].avatarUrl`	string
`traders[].roi`	number
`traders[].pnl`	number
`traders[].pnlCurrency`	string
`traders[].sourceDetails.followers`	only Bybit
`traders[].sourceDetails.sharingPositions`	only Bybit
`traders[].sourceDetails.editions`	only Bybit
`traders[].sourceDetails.winningDays`	only Bybit
`traders[].sourceDetails.trades`	only Bybit
`traders[].rank`	number
`hasMore`always	boolean	true when another page follows
`total`always	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bybit-leaderboard/traderSearch?name=Nev*"

{
  "data": {
    "traders": [
      {
        "traderId": "6LBl1dpjnE91knEy",
        "name": "Nev***",
        "rank": 3,
        "pnl": 10137037.69,
        "pnlCurrency": "USD",
        "sourceDetails": {
          "followers": 0,
          "sharingPositions": false,
          "editions": {
            "weekly": 28,
            "biweekly": 18,
            "monthly": 12
          },
          "winningDays": 55,
          "trades": 31885
        }
      }
    ],
    "hasMore": false,
    "total": 1
  }
}

Trader profile

GET /v5/bybit-leaderboard/traderProfile

The trader's followers, editions ranked in and how their assets are split.

Query parameters

Name	Type	Description
`traderId`required	string	The trader's hashId, from traders or editions

Response fields, in `data`

Field	Type	Description
`traderId`always	string
`name`	string
`avatarUrl`	string
`sourceDetails.followers`	only Bybit
`sourceDetails.following`	only Bybit
`sourceDetails.likes`	only Bybit
`sourceDetails.joinedAt`	only Bybit
`sourceDetails.sharingPositions`	only Bybit
`sourceDetails.editions`	only Bybit
`sourceDetails.assets`	only Bybit

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bybit-leaderboard/traderProfile?traderId=6LBl1dpjnE91knEy"

{
  "data": {
    "traderId": "6LBl1dpjnE91knEy",
    "name": "NeverTradingUnkow",
    "sourceDetails": {
      "followers": 239,
      "following": 0,
      "likes": 139,
      "joinedAt": 1696074462000,
      "sharingPositions": false,
      "editions": {
        "weekly": 28,
        "biweekly": 18,
        "monthly": 12
      },
      "assets": [
        {
          "type": "unified",
          "share": 1
        },
        {
          "type": "contract",
          "share": 0
        },
        {
          "type": "investment",
          "share": 0
        }
      ]
    }
  }
}

Trader chart

GET /v5/bybit-leaderboard/traderChart

The trader's ROI, one point a day, as fractions, oldest first.

Query parameters

Name	Type	Description
`traderId`required	string	The trader's hashId, from traders or editions
`metric`	enumdefault TOTAL_ROI	Cumulative ROI, or each day'sTOTAL_ROI, DAILY_ROI

Response fields, in `data`

Field	Type	Description
`metric`always	string	What the points measure: ROI, PNL or BALANCE
`points[]`always	array
`points[].timestamp`always	number	Point time, in Unix milliseconds
`points[].value`always	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bybit-leaderboard/traderChart?traderId=6LBl1dpjnE91knEy"

{
  "data": {
    "metric": "TOTAL_ROI",
    "points": [
      {
        "timestamp": 1784505600000,
        "value": -0.0668
      },
      {
        "timestamp": 1784592000000,
        "value": -0.0667
      },
      {
        "timestamp": 1784678400000,
        "value": -0.0683
      }
    ]
  }
}

Open positions

GET /v5/bybit-leaderboard/openPositions

The trader's open positions, when the trader shares them (sharingPositions). Bybit gives no size, mark price or PnL.

Query parameters

Name	Type	Description
`traderId`required	string	The trader's hashId, from traders or editions
`contractType`	enumdefault all	Only this kind of contractall, usdtPerpetual, usdcPerpetual, inversePerpetual, usdcFutures, inverseFutures

Response fields, in `data`

Field	Type	Description
`positions[]`always	array
`positions[].symbol`always	string
`positions[].side`always	LONG \| SHORT
`positions[].entryPrice`always	number
`positions[].leverage`	number
`positions[].liquidationPrice`	number
`positions[].sourceDetails.value`	only Bybit
`positions[].sourceDetails.contractType`	only Bybit

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/bybit-leaderboard/openPositions?traderId=kJzgVNGr489B1yW7"

{
  "data": {
    "positions": []
  }
}

Stream and webhooks

Paid plans can follow a trader in real time over wss://api.kopyon.com/v5/streamor through signed webhooks. Topics for this source:

openPositions: Open positions, whenever they change
positionEvents: Opened, increased, decreased, closed

Stream messages and webhook signatures

Bybit Leaderboard API

Traders

Query parameters

Response fields, in data

Example

Search traders

Query parameters

Response fields, in data

Example

Trader profile

Query parameters

Response fields, in data

Example

Trader chart

Query parameters

Response fields, in data

Example

Open positions

Query parameters

Response fields, in data

Example

Stream and webhooks

Try the Bybit Leaderboard API for free.

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`