Get Profit Details

Description

Get the profit-sharing detail records for a copy-trading lead account.

HTTP Request

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

Request

curl "https://api.bitget.com/api/v3/copy/futures/profit-details" \
   -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
startTime	String	No	Start timestamp (Unix ms, e.g. 1597026383085)
endTime	String	No	End timestamp (Unix ms, e.g. 1597026383085)
limit	String	No	Number of results. Default: 20, max: 100
cursor	String	No	Cursor ID. Pass the cursor returned from the previous call to paginate forward (newer records).

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "list": [
      {
        "followerName": "Alice",
        "profit": "500.00",
        "allocatedPnl": "400.00",
        "pendingPnl": "100.00",
        "shareRatio": "0.1",
        "shareProfit": "50.00",
        "reason": "period",
        "settleTime": "1740000000000"
      }
    ],
    "nextCursor": "1234567890"
  }
}

Response Parameters

Parameter	Type	Description
list	Array	Profit detail list
> followerName	String	Follower name
> profit	String	Follower's profit and loss
> allocatedPnl	String	Allocated profit and loss
> pendingPnl	String	Pending profit and loss
> shareRatio	String	Profit-sharing ratio (decimal form)
> shareProfit	String	Profit-sharing amount
> reason	String	Reason period Periodic settlement unfollow Settlement upon unfollow
> settleTime	String	Settlement time (Unix ms)
nextCursor	String	Cursor ID