Get Trader List
Frequency limit: 10 times/1s (uid)
HTTP Request
- GET /api/v2/copy/mix-broker/query-traders
Request Example
curl "https://api.cointr.com/api/v2/copy/mix-broker/query-traders?sortRule=roi&sortFlag=desc&languageType=zh-CN&pageNo=1&pageSize=20&fullStatus=all" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
traderId | String | No | Trader user ID |
traderName | String | No | Trader alias (fuzzy match) e.g. Zhang => Zhang San, Zhang Tianming |
fullStatus | String | No | Full or not (querying all by default) Full: Querying elite traders reaching maximum capacity for followers All: Querying all |
sortRule | String | No | Sorting rules Composite by default Composite: Based on overall performance ROI: Based on ROI totalPL: Based on total PnL AUM: Based on AUM |
sortFlag | String | No | Sorting in reverse order Default: Desc Asc: ascending Desc: descending |
language | String | No | Chinese or English, affecting columnList.describe in the results zh-CN: Chinese en-US: English |
pageSize | String | No | Number of queries: Default: 20, maximum: 20. |
pageNo | String | No | Page number: Default: 1 |
Response example
{
"code": "00000",
"msg": "success",
"requestTime": 1695872676719,
"data": [
{
"canTrace": "Yes",
"traderId": "**********",
"traderName": "xx-111111",
"maxLimit": "750",
"platskMaxFollowLimit": "75",
"followCount": "23",
"platskFollowCount": "49",
"traderStatus": "No",
"currentTradingList": [
"10000LADYSUSDT",
"1000XECUSDT"
],
"columnList": [
{
"describe": "ROI",
"value": "5739.62"
},
{
"describe": "Total PnL",
"value": "$12,376.16"
},
{
"describe": "Total followers PnL",
"value": "$747.81"
},
{
"describe": "AUM",
"value": "$50,079.15"
},
{
"describe": "Max drawdown",
"value": "2.09"
},
{
"describe": "Last 3W win rate",
"value": "100.00"
}
],
"totalFollowers": "49",
"profitCount": "108",
"lossCount": "0",
"tradeCount": "108",
"traderPic": "",
"maxCallbackRate": "2.099517",
"averageWinRate": "100",
"dailyProfitRateList": [
{
"rate": "4133.695901",
"cTime": "1693238400000"
}
],
"dailyProfitList": [
{
"amount": "7715.9787",
"cTime": "1693238400000"
}
],
"followerTotalProfit": "747.81119997",
"profitRate24hList": [
{
"rate": "6133.845805",
"cTime": "1695744000000"
}
],
"profit24hList": [
{
"amount": "12376.1621",
"cTime": "1695744000000"
}
],
"lastTradeTime": "1695780099629",
"tradeDays": "19629"
}
]
}
Response parameters
Parameter | Type | Description |
---|---|---|
canTrace | String | Allow to follow or not Yes No |
traderId | String | Trader ID, string |
traderName | String | Trader alias |
maxLimit | String | Maximum number of followers |
platskMaxFollowLimit | String | Maximum number of followers granted by PLATSK holdings |
followCount | String | Current number of followers |
platskFollowCount | String | Number of followers granted by PLATSK holdings |
traderStatus | String | Already following or not? Yes No |
currentTradingList | List<String> | Return up to three trading pairs Current underlying assets for copy trading |
columnList | List | Elite trader performance indicators |
>describe | String | Indicator description, returning the description in different languages based on languageType. |
>value | String | Indicator value |
totalFollowers | String | Total number of followers |
profitCount | String | Number of trades with positive profits |
lossCount | String | Number of trades with losses |
tradeCount | String | Number of transactions |
traderPic | String | Elite trader avatar (url) |
maxCallbackRate | String | Maximum drawdown |
averageWinRate | String | Average win rate |
dailyProfitRateList | List | Recent 30days daily ROI |
>rate | String | Interest rate |
>ctime | String | Time |
dailyProfitList | List | Recent 30days daily PnL |
>amount | String | Amount |
>ctime | String | Time |
followerTotalProfit | String | Followers' total profits |
profitRate24hList | List | ROI for the last 24 hours |
>rate | String | Interest rate |
>ctime | String | Time |
profit24hList | List | PnL for the last 24 hours |
>amount | String | Amount |
>ctime | String | Time |
lastTradeTime | String | Last trading time |
tradeDays | String | Elite trade duration (days) |