Getting Started
Trader Explorer
Trader Profile
Open Interest
Trader Board
Copy Trades
Trader Statistics
Copy
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
}
]
}
'Copy
{
"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
}
}Mixins
Trader Statistics
Retrieve statistics for traders
POST
/
public
/
{protocol}
/
position
/
statistic
/
filter
Trader Statistics
Copy
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
}
]
}
'Copy
{
"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
}
}Get Trader Statistics
This endpoint allows you to retrieve detailed statistics for traders on a specific protocol.Path Parameters
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, HYPERLIQUID, OSTIUM_ARBRequest Body
Field to sort by. Can be any of the fieldName values in ranges.
Sort direction. Values:
desc, ascArray of range objects
Show properties
Show properties
Field name to filter. Supported values: -
lastTradeAtTs: Timestamp of
last trade - runTimeDays: Number of days since the first trade - pnl:
PnL including fee - realisedPnl: PnL without fee - avgRoi: Average ROI
including fee - realisedAvgRoi: Average ROI without fee - totalGain:
Total gain including fee - realisedTotalGain: Total gain without fee -
totalLoss: Total loss including fee - realisedTotalLoss: Total loss
without fee - totalFee: Total fee - totalVolume: Total volume -
avgVolume: Average volume - maxRoi: Maximum ROI including fee -
realisedMaxRoi: Maximum ROI without fee - maxDrawdown: Max drawdown
including fee - realisedMaxDrawdown: Max drawdown without fee -
totalTrade: Total trades - totalWin: Total wins - totalLose: Total
loses - totalLiquidation: Total liquidations - winRate: Win Rate
(percent) - profitRate: Total gain / (Total gain + Total loss) (percent,
including fee) - realisedProfitRate: Total gain / (Total gain + Total
loss) (percent, without fee) - longRate: Long Positions / Total
Positions (percent) - orderPositionRatio: Total Orders / Total PositionsprofitLossRatio: (Total gain / Total win) / (Total loss / Total lose) (including fee) -realisedProfitLossRatio: (Total gain / Total win) / (Total loss / Total lose) (without fee) -gainLossRatio: Total gain / Total loss (including fee) -realisedGainLossRatio: Total gain / Total loss (without fee) -avgLeverage: Average leverage -maxLeverage: Maximum leverage -minLeverage: Minimum leverage -avgDuration: Average duration in seconds -minDuration: Minimum duration in seconds -maxDuration: Maximum duration in seconds
Greater than or equal to value
Less than or equal to value
Request Example
Copy
{
"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
Array of trader statistics
Show properties
Show properties
Unique identifier for the trader
Trader’s account address
Total number of trades
Total number of winning trades
Total number of losing trades
Total gain including fee
Total gain without fee
Total loss including fee
Total loss without fee
Total trading volume
Average trading volume
Average ROI including fee
Average ROI without fee
Maximum ROI including fee
Maximum ROI without fee
Profit and Loss including fee
Profit and Loss without fee
Maximum drawdown including fee
Maximum drawdown without fee
Win rate percentage
Profit rate including fee
Profit rate without fee
Percentage of long positions
Gain/loss ratio including fee
Gain/loss ratio without fee
Average position duration in seconds
Average leverage used
Total number of liquidations
Number of days since first trade
Timestamp of last trade
Total fees paid
Protocol name
Response Example
Copy
{
"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
}
}
⌘I