Get History Followers

Description

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

HTTP Request

• GET /api/v3/copy/futures/history-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/history-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": "Bob",
        "totalProfit": "200.00",
        "totalShareProfit": "20.00",
        "totalInvestment": "5000.00",
        "startTime": "1730000000000",
        "endTime": "1740000000000"
      }
    ],
    "nextCursor": "1234567890"
  }
}

Response Parameters

Parameter	Type	Description
list	Array	Historical follower list
> followerName	String	Follower nickname
> totalProfit	String	Total profit (USDT)
> totalShareProfit	String	Total profit share (USDT)
> totalInvestment	String	Total investment (USDT)
> startTime	String	Follow start time (Unix ms)
> endTime	String	Follow end time (Unix ms)
nextCursor	String	Next page cursor