Skip to main content
POST
/
public
/
{protocol}
/
position
/
statistic
/
filter
Trader Statistics
curl --request POST \
  --url https://api.copin.io/public/{protocol}/position/statistic/filter \
  --header 'Content-Type: application/json' \
  --data '
{
  "pagination": {
    "limit": 123,
    "offset": 123
  },
  "sortBy": "<string>",
  "sortType": "<string>",
  "queries": [
    {
      "fieldName": "<string>",
      "value": "<string>"
    }
  ],
  "ranges": [
    {
      "fieldName": "<string>",
      "gte": 123,
      "lte": 123
    }
  ]
}
'
{
  "data": [
    {
      "id": "<string>",
      "account": "<string>",
      "totalTrade": 123,
      "totalWin": 123,
      "totalLose": 123,
      "totalGain": 123,
      "realisedTotalGain": 123,
      "totalLoss": 123,
      "realisedTotalLoss": 123,
      "totalVolume": 123,
      "avgVolume": 123,
      "avgRoi": 123,
      "realisedAvgRoi": 123,
      "maxRoi": 123,
      "realisedMaxRoi": 123,
      "pnl": 123,
      "realisedPnl": 123,
      "maxDrawdown": 123,
      "realisedMaxDrawdown": 123,
      "winRate": 123,
      "profitRate": 123,
      "realisedProfitRate": 123,
      "longRate": 123,
      "gainLossRatio": 123,
      "realisedGainLossRatio": 123,
      "avgDuration": 123,
      "avgLeverage": 123,
      "totalLiquidation": 123,
      "runTimeDays": 123,
      "lastTradeAtTs": 123,
      "totalFee": 123,
      "protocol": "<string>"
    }
  ],
  "meta": {
    "limit": 123,
    "offset": 123,
    "total": 123,
    "totalPages": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.copin.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Trader Statistics

This endpoint allows you to retrieve detailed statistics for traders on a specific protocol.

​
Authentication

This endpoint requires authentication using a JWT token or API-KEY in the header.
​
Authorization
string
JWT token in the format: Authorization {token}
​
x-api-key
string
Token in the format: x-api-key {api-key}

​
Path Parameters

​
protocol
string
required
The supported protocols 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, PERPETUAL_OP, JUPITER, HOLDSTATION_BERA, GMX_SOL, OSTIUM_ARB

​
Request Body

​
pagination
object
Pagination parameters
​
sortBy
string
Field to sort by. Can be any of the fieldName values in ranges.
​
sortType
string
Sort direction. Values: desc, asc
​
queries
array
Array of query objects
​
ranges
array
Array of range objects

​
Request Example

{
  "pagination": {
    "limit": 20,
    "offset": 0
  },
  "queries": [
    {
      "fieldName": "type",
      "value": "D30"
    }
  ],
  "ranges": [
    {
      "fieldName": "realisedPnl",
      "gte": 1000
    },
    {
      "fieldName": "lastTradeAtTs",
      "gte": 1696240506809
    },
    {
      "fieldName": "totalWin",
      "gte": 5
    },
    {
      "fieldName": "realisedAvgRoi",
      "gte": 20
    },
    {
      "fieldName": "winRate",
      "gte": 80
    },
    {
      "fieldName": "realisedMaxDrawdown",
      "gte": -30
    }
  ],
  "sortBy": "realisedPnl",
  "sortType": "desc"
}

​
Response

​
data
array
Array of trader statistics
​
meta
object
Metadata about the response

​
Response Example

{
  "data": [
    {
      "id": "656291e14350fb0b6981e6ce",
      "account": "0x9f431A46149bab70373B9C6867d2dB8C2F45aa11",
      "totalTrade": 10,
      "totalWin": 10,
      "totalLose": 0,
      "totalGain": 57060.90483687067,
      "realisedTotalGain": 53926.13225839167,
      "totalLoss": 0,
      "realisedTotalLoss": 0,
      "totalVolume": 3504221.760537487,
      "avgVolume": 350422.1760537487,
      "avgRoi": 33.43488693937744,
      "realisedAvgRoi": 37.47677597570163,
      "maxRoi": 104.1059947215304,
      "realisedMaxRoi": 109.65725913031952,
      "pnl": 53926.13225839167,
      "realisedPnl": 57060.90483687067,
      "maxPnl": 16673.619290696948,
      "realisedMaxPnl": 17269.147842961316,
      "maxDrawdown": 0,
      "realisedMaxDrawdown": 0,
      "maxDrawdownPnl": 0,
      "realisedMaxDrawdownPnl": 0,
      "winRate": 100,
      "profitRate": 100,
      "realisedProfitRate": 100,
      "orderPositionRatio": 2.1,
      "profitLossRatio": 0,
      "realisedProfitLossRatio": 0,
      "longRate": 100,
      "gainLossRatio": 57060.90483687067,
      "realisedGainLossRatio": 53926.13225839167,
      "avgDuration": 68629,
      "minDuration": 11976,
      "maxDuration": 206986,
      "avgLeverage": 20.210503401712398,
      "minLeverage": 5.020509333784338,
      "maxLeverage": 30.179561022789816,
      "totalLiquidation": 0,
      "totalLiquidationAmount": 0,
      "runTimeDays": 139,
      "lastTradeAtTs": 1701696239000,
      "totalFee": 3134.772578479,
      "type": "D30",
      "statisticAt": "2023-12-05T00:05:59.524Z",
      "lastTradeAt": "2023-12-04T13:23:59.000Z",
      "createdAt": "2023-11-26T00:31:28.532Z",
      "isOpenPosition": true,
      "protocol": "KWENTA"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 15,
    "totalPages": 1
  }
}