Get Trader List

Rate Limit: 5 req/sec/UID

HTTP Request

• GET /api/v2/copy/mix-broker/query-traders

Request Example

curl "https://api.bitget.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": 1679453151215,
  "data": [
    {
      "canTrace": "Yes",
      "traderId": "**********",
      "traderName": "xx-111111",
      "maxLimit": "750",
      "bgbMaxFollowLimit": "75",
      "followCount": "23",
      "bgbFollowCount": "49",
      "traderStatus": "No",
      "totalEquity":"****",
      "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
bgbMaxFollowLimit	String	Maximum number of followers granted by BGB holdings
followCount	String	Current number of followers
bgbFollowCount	String	Number of followers granted by BGB holdings
traderStatus	String	Already following or not? Yes No
totalEquity	String	Trader equity
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)