GET
/
leaderboards
/
page
curl --request GET \
  --url https://api.copin.io/leaderboards/page
{
  "data": [
    {
      "id": "<string>",
      "account": "<string>",
      "protocol": "<string>",
      "statisticType": "<string>",
      "rankingAt": "<string>",
      "ranking": 123,
      "lastRanking": 123,
      "totalPnl": 123,
      "totalRealisedPnl": 123,
      "totalVolume": 123,
      "totalFee": 123,
      "totalTrade": 123,
      "totalWin": 123,
      "totalLose": 123,
      "totalLiquidation": 123,
      "totalLiquidationAmount": 123,
      "createdAt": "<string>"
    }
  ],
  "meta": {
    "limit": 123,
    "offset": 123,
    "total": 123,
    "totalPages": 123
  }
}

​
Query Parameters

​
protocol
string
required

The protocol to get leaderboard for. Supported values include: GMX, KWENTA, POLYNOMIAL, POLYNOMIAL_L2, GMX_V2_AVAX, GMX_V2, GNS, GNS_POLY, GNS_BASE, GNS_APE, LEVEL_BNB, LEVEL_ARB, MUX_ARB, APOLLOX_BNB, AVANTIS_BASE, EQUATION_ARB, LOGX_BLAST, LOGX_MODE, MYX_ARB, DEXTORO, VELA_ARB, HMX_ARB, SYNTHETIX_V3, SYNTHETIX_V3_ARB, KTX_MANTLE, CYBERDEX, YFX_ARB, KILOEX_OPBNB, KILOEX_BNB, KILOEX_MANTA, KILOEX_BASE, ROLLIE_SCROLL, MUMMY_FANTOM, HYPERLIQUID, SYNFUTURE_BASE, MORPHEX_FANTOM, PERENNIAL_ARB, BSX_BASE, DYDX, UNIDEX_ARB, VERTEX_ARB, HORIZON_BNB, HOLDSTATION_ZKSYNC, ZENO_METIS, LINEHUB_LINEA, BMX_BASE, FOXIFY_ARB, APOLLOX_BASE, GMX_AVAX, SYNTHETIX, DEPERP_BASE, ELFI_ARB

​
queryDate
number
required

Date in timestamp format

​
statisticType
string
required

Type of statistics. Values: MONTH, WEEK

​
limit
number
default:"20"

Number of records to return

​
offset
number
default:"0"

Number of records to skip

​
sort_by
string

Field to sort by. Values: ranking, totalPnl, totalRealisedPnl, totalVolume, totalFee, totalTrade, totalWin, totalLose, totalLiquidation, totalLiquidationAmount

​
sort_type
string

Sort direction. Values: asc, desc

​
Request Example

curl -X GET "https://api.copin.io/leaderboards/page?protocol=KWENTA&queryDate=1701835880676&statisticType=MONTH&limit=20&offset=0&sort_by=ranking&sort_type=asc" \
  -H "X-COPIN_API_KEY: YOUR_COPIN_API_KEY"

​
Response

​
data
array

Array of traders in the leaderboard

​
meta
object

Metadata about the response

​
Response Example

{
  "data": [
    {
      "id": "656fb9897fdc207f19e4ef1f",
      "account": "0x92812499fF2c040f93121Aab684680a6e603C4A7",
      "protocol": "KWENTA",
      "statisticType": "MONTH",
      "rankingAt": "2023-12-06T00:00:08.841Z",
      "ranking": 1,
      "lastRanking": 1,
      "totalPnl": 2124229.3913290403,
      "totalRealisedPnl": 2137944.463823661,
      "totalVolume": 11012185.066084206,
      "totalFee": 13715.072494621,
      "totalTrade": 1,
      "totalWin": 1,
      "totalLose": 0,
      "totalLiquidation": 0,
      "totalLiquidationAmount": 0,
      "createdAt": "2023-12-06T00:00:09.748Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 728,
    "totalPages": 37
  }
}