Get Current Followers

Description

Get the list of current active followers for a copy-trading lead account.

HTTP Request

• GET /api/v3/copy/futures/current-follower
• Rate limit: 1/sec/UID
• Permission: Unified Account — Futures Copy-Trading Orders — Read-only

Request

curl "https://api.bitget.com/api/v3/copy/futures/current-follower" \
   -H "ACCESS-KEY:*******" \
   -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
limit	String	No	Number of results. Default: 20, max: 100
cursor	String	No	Cursor ID. Pass the endId returned from the previous call to paginate forward (newer records).

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "list": [
      {
        "followerName": "Alice",
        "estimateAssets": "10000.00",
        "totalProfit": "500.00",
        "totalShareProfit": "50.00",
        "totalInvestment": "9500.00",
        "canRemove": "no",
        "followDays": "30",
        "totalAssets": "10500.00",
        "startTime": "1740000000000"
      }
    ],
    "nextCursor": "1234567890"
  }
}

Response Parameters

Parameter	Type	Description
list	Array	Follower list
> followerName	String	Follower nickname
> estimateAssets	String	Estimated asset value (USDT)
> totalProfit	String	Total profit (USDT)
> totalShareProfit	String	Total profit share (USDT)
> totalInvestment	String	Total investment (USDT)
> canRemove	String	Whether the follower can be removed yes Yes no No
> followDays	String	Number of days following (positive integer)
> totalAssets	String	Account equity (USDT)
> startTime	String	Follow start time (Unix ms)
nextCursor	String	Next page cursor