Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Copy Trading
    Futures Public/Private
      Get Position SummarygetGet Trading PairsgetGet Max TransferablegetTransferpostGet Transfer RecordgetGet Current FollowersgetGet History FollowersgetGet Profit SummarygetGet Profit Detailsget
Copy Trading
Copy Trading

Futures Public/Private

Futures Public/Private


Get Position Summary

GET
https://api.bitget.com
/api/v3/copy/futures/position-summary

Rate limit: 5/sec/UID

Permission: Unified Account — Futures Copy-Trading Positions — Read-only

Get position summary

Get Position Summary › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
unrealizedPnl
​string

Unrealized PnL unit: USDT

realizedPnl
​string

Realized PnL unit: USDT

holdSize
​string

Position size

avgPrice
​string

Average entry price

symbol
​string

Symbol name

leverage
​string

Leverage multiplier positive integer

marginMode
​string

Margin mode: isolated isolated cross cross

liqPrice
​string

Liquidation price

margin
​string

Margin

holdSide
​string

Position side: long long short short

roi
​string

Return on investment (ROI)

markPrice
​string

Mark price

positionValue
​string

Position value unit: USDT

GET/api/v3/copy/futures/position-summary
curl https://api.bitget.com/api/v3/copy/futures/position-summary
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1774957537393, "data": [ { "unrealizedPnl": "0.0095", "realizedPnl": "-0.0085658580000000", "holdSize": "0.01", "avgPrice": "2039.49", "symbol": "ETHUSDT", "leverage": "10", "marginMode": "crossed", "liqPrice": "0", "margin": "2.04900984", "holdSide": "long", "roi": "0.0046363857202896", "markPrice": "2040.44", "positionValue": "20.4044" } ] }
json
application/json

Get Trading Pairs

GET
https://api.bitget.com
/api/v3/copy/futures/trading-pairs

Rate limit: 5/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

Get copy-trading symbol

Get Trading Pairs › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
symbol
​string

Symbol name

leverage
​string

Leverage multiplier

​object[]

Margin details list

GET/api/v3/copy/futures/trading-pairs
curl https://api.bitget.com/api/v3/copy/futures/trading-pairs
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1774957070136, "data": [ { "symbol": "ADAUSDT", "leverage": "50", "marginDetails": [ { "marginCoin": "USDT", "maxLongCount": "9600000", "remainingLongCount": "9600000", "maxShortCount": "9600000", "remainingShortCount": "9600000" } ] } ] }
json
application/json

Get Max Transferable

GET
https://api.bitget.com
/api/v3/copy/futures/max-transferable

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

Get the maximum transferable amount and available balance for a copy-trading lead account.

Get Max Transferable › Request Parameters

coin
​string · required

Coin name, e.g. USDT

Get Max Transferable › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
maxTransferable
​string

Maximum transferable amount

available
​string

Available balance

GET/api/v3/copy/futures/max-transferable
curl 'https://api.bitget.com/api/v3/copy/futures/max-transferable?coin=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "maxTransferable": "1000.00", "available": "1200.00" } }
json
application/json

Transfer

POST
https://api.bitget.com
/api/v3/copy/futures/transfer

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-write

Transfer funds into or out of a copy-trading lead account. Only transfers between the spot/funding account and the lead account are supported.

Transfer › Request Parameters

type
​string · required

Transfer direction in Transfer in (spot/funding account -> lead account) out Transfer out (lead account -> spot/funding account)

coin
​string · required

Transfer coin

amount
​string · required

Transfer amount

inAccountType
​string

Source account type for transfer-in. Multiple types supported, separated by commas (,). funding Spot/funding account uta Unified account otc OTC account If not specified, all account types are selected by default. Deduction order: funding account -> OTC account -> unified account. Classic account mode only supports funding (spot account) as the source.

Transfer › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
transferId
​string

Transfer ID

POST/api/v3/copy/futures/transfer
curl 'https://api.bitget.com/api/v3/copy/futures/transfer?type=<string>&coin=<string>&amount=<string>' \ --request POST
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "transferId": "1234567890" } }
json
application/json

Get Transfer Record

GET
https://api.bitget.com
/api/v3/copy/futures/transfer-record

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

Query transfer history for a copy-trading lead account.

Get Transfer Record › Request Parameters

startTime
​string

Start timestamp (Unix ms, e.g. 1597026383085)

endTime
​string

End timestamp (Unix ms, e.g. 1597026383085)

limit
​string

Number of results. Default: 20, max: 100

cursor
​string

Cursor ID. Pass the transferId returned from the previous call to paginate forward (newer records).

Get Transfer Record › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

Transfer record list

GET/api/v3/copy/futures/transfer-record
curl https://api.bitget.com/api/v3/copy/futures/transfer-record
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "transferId": "1234567890", "fromType": "spot,uta", "toType": "lead", "amount": "100.00", "coin": "USDT", "status": "Successful", "createdTime": "1740000000000" } ] } }
json
application/json

Get Current Followers

GET
https://api.bitget.com
/api/v3/copy/futures/current-follower

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

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

Get Current Followers › Request Parameters

limit
​string

Number of results. Default: 20, max: 100

cursor
​string

Cursor ID. Pass the endId returned from the previous call to paginate forward (newer records).

Get Current Followers › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

Follower list

nextCursor
​string

Next page cursor

GET/api/v3/copy/futures/current-follower
curl https://api.bitget.com/api/v3/copy/futures/current-follower
Example Responses
{ "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" } }
json
application/json

Get History Followers

GET
https://api.bitget.com
/api/v3/copy/futures/history-follower

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

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

Get History Followers › Request Parameters

limit
​string

Number of results. Default: 20, max: 100

cursor
​string

Cursor ID. Pass the endId returned from the previous call to paginate forward (newer records).

Get History Followers › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

Historical follower list

nextCursor
​string

Next page cursor

GET/api/v3/copy/futures/history-follower
curl https://api.bitget.com/api/v3/copy/futures/history-follower
Example Responses
{ "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" } }
json
application/json

Get Profit Summary

GET
https://api.bitget.com
/api/v3/copy/futures/profit-summary

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

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

Get Profit Summary › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
totalProfit
​string

Cumulative profit (USDT)

totalAllocatedProfit
​string

Cumulative allocated profit share (USDT)

totalPendingProfit
​string

Cumulative pending profit share (USDT)

GET/api/v3/copy/futures/profit-summary
curl https://api.bitget.com/api/v3/copy/futures/profit-summary
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "totalProfit": "10000.00", "totalAllocatedProfit": "8000.00", "totalPendingProfit": "2000.00" } }
json
application/json

Get Profit Details

GET
https://api.bitget.com
/api/v3/copy/futures/profit-details

Rate limit: 1/sec/UID

Permission: Unified Account — Futures Copy-Trading Orders — Read-only

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

Get Profit Details › Request Parameters

startTime
​string

Start timestamp (Unix ms, e.g. 1597026383085)

endTime
​string

End timestamp (Unix ms, e.g. 1597026383085)

limit
​string

Number of results. Default: 20, max: 100

cursor
​string

Cursor ID. Pass the cursor returned from the previous call to paginate forward (newer records).

Get Profit Details › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
​object[]

Profit detail list

nextCursor
​string

Cursor ID

GET/api/v3/copy/futures/profit-details
curl https://api.bitget.com/api/v3/copy/futures/profit-details
Example Responses
{ "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" } }
json
application/json