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) |