Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
API Document
Classic Account
    Copy Trading · Spot Copy · Follower
      Cancel FollowpostSell And Sell in BatchpostGet Current Copy Trade OrdersgetGet History Tracking OrdersgetGet Follow ConfigurationgetGet Trader's Current Trading PairgetMy Trader ListgetSet Take Profit And Stop LosspostAdd or Modify Following ConfigurationspostStop The Orderpost
Classic Spot Copy Trading Follower API
Classic Spot Copy Trading Follower API

Copy Trading · Spot Copy · Follower

Classic Account — Copy Trading · Spot Copy · Follower


Cancel Follow

POST
https://api.bitget.com
/api/v2/copy/spot-follower/cancel-trader

Rate Limit: 1 req/sec/UID

Cancel Follow › Request Parameters

traderId
​string · required

Trader user ID

Cancel Follow › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
data
​string

Result

success Success

others fail

POST/api/v2/copy/spot-follower/cancel-trader
curl https://api.bitget.com/api/v2/copy/spot-follower/cancel-trader \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "traderId": "traderId" }'
Example Request Body
{ "traderId": "traderId" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json

Sell And Sell in Batch

POST
https://api.bitget.com
/api/v2/copy/spot-follower/order-close-tracking

Rate Limit: 1 req/sec/UID

Sell And Sell in Batch › Request Parameters

trackingNoList
​string[] · required

Tracking numbers of buying orders grouped by trading pair; all successful or all failed; up to 50 order tracking numbers

symbol
​string · required

Trading pair

Sell And Sell in Batch › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
data
​string

Result

success Success

others fail

POST/api/v2/copy/spot-follower/order-close-tracking
curl https://api.bitget.com/api/v2/copy/spot-follower/order-close-tracking \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "trackingNoList": [ "string" ], "symbol": "symbol" }'
Example Request Body
{ "trackingNoList": [ "string" ], "symbol": "symbol" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json

Get Current Copy Trade Orders

GET
https://api.bitget.com
/api/v2/copy/spot-follower/query-current-orders

Rate limit: 5 req/sec/UID

Get Current Copy Trade Orders › Request Parameters

symbol
​string

Trading pair

traderId
​string

trader id

idLessThan
​string

Before requesting this ID

idGreaterThan
​string

After requesting this ID

startTime
​string

start time

endTime
​string

end time )

limit
​string

The default is 20, with a maximum support of 50. More than 20 items will be returned

Get Current Copy Trade Orders › Response Parameters

200

Successful response

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

tracking list

trackingNo
​string

Track order number

traderId
​string

trader Id

buyFillSize
​string

Filled buy quantity

buyDelegateSize
​string

Buy order quantity

buyPrice
​string

buy price

unrealizedPL
​string

Current unrealized PnL

buyTime
​string

Time of buying

buyFee
​string

Buying transaction Fee

unrealizedPLR
​string

Current ROI of unrealized PnL

If the value is 11.11, it represents 11.11%

symbol
​string

Trading pair

stopSurplusPrice
​string

Stop profit price

stopLossPrice
​string

Stop loss price

endId
​string

The final data ID. The ID value is the tracking number used for querying based on the ID

GET/api/v2/copy/spot-follower/query-current-orders
curl https://api.bitget.com/api/v2/copy/spot-follower/query-current-orders
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695809370190, "data": { "endId": "1", "trackingList": [ { "trackingNo": "1", "traderId": "**********", "buyFillSize": "0.0317", "buyDelegateSize": "0.0317190800000000", "buyPrice": "34870.7", "unrealizedPL": "-0.77945295", "buyTime": "1695729895491", "buyFee": "-0.00001908", "unrealizedPLR": "-0.07", "symbol": "BTCUSDT", "stopSurplusPrice": null, "stopLossPrice": null } ] } }
json
application/json

Get History Tracking Orders

GET
https://api.bitget.com
/api/v2/copy/spot-follower/query-history-orders

Rate Limit: 5 req/sec/UID

Get History Tracking Orders › Request Parameters

symbol
​string

Trading pair

traderId
​string

trader Id

idLessThan
​string

Before requesting this ID

idGreaterThan
​string

After requesting this ID

startTime
​string

start time

endTime
​string

end time

limit
​string

The default is 20, with a maximum support of 50. More than 20 items will be returned

Get History Tracking Orders › Response Parameters

200

Successful response

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

tracking list

trackingNo
​string

Track order number

traderId
​string

trader Id

fillSize
​string

Filled quantity

buyPrice
​string

Average buying price

sellPrice
​string

Average selling price

achievedPL
​string

Realized PnL

buyTime
​string

Time of buying

sellTime
​string

Time of selling

buyFee
​string

Buying transaction Fee

sellFee
​string

Selling transaction fee

achievedPLR
​string

ROI of realized PnL. If the value is 11.11, it represents 11.11%.

symbol
​string

Trading pair

endId
​string

The final data ID. The ID value is the tracking number used for querying based on the ID

GET/api/v2/copy/spot-follower/query-history-orders
curl https://api.bitget.com/api/v2/copy/spot-follower/query-history-orders
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695811537460, "data": { "endId": "1", "trackingList": [ { "trackingNo": "1", "traderId": "**********", "fillSize": "0.0316", "buyPrice": "34870.7", "sellPrice": "34865.5", "buyFee": "-0.00001902", "sellFee": "-0.66104988", "achievedPL": "-0.82756", "achievedPLR": "-0.07", "symbol": "BTCUSDT", "buyTime": "1695729617968", "sellTime": "1695729886269" } ] } }
json
application/json

Get Follow Configuration

GET
https://api.bitget.com
/api/v2/copy/spot-follower/query-settings

Rate Limit: 10 req/sec/UID

Get Follow Configuration › Request Parameters

traderId
​string · required

Trader user ID

Get Follow Configuration › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
enable
​string

Am I following

profitRate
​string

profit Rate

settledInDays
​string

Trader membership period (starting from the registration date)

traderHeadPic
​string

trader avatar

traderName
​string

trader nick name

​object[]

My copy trade settings

maxTraceAmount
​string

Maximum copy trade buying coin (base currency)

stopLossRation
​string

Stop-loss ratio

If the value is 11.11, it represents 11.11%

stopSurplusRation
​string

Take-profit ratio

If the value is 11.11, it represents 11.11%

symbol
​string

Trading pair ID

traceType
​string

Copy trade type

percent Set the percentage of the copy trade amount to the trader's elite trade amount. For example, 1 means the follower invests the same amount to open a position as the elite trader, and 2 means the follower invests twice the amount of the elite trader.

amount The fixed volume specified for copy trading

count Number of copy trade orders with fixed volume

​object[]

Trading pair copy trading configuration

maxStopLossRation
​string

Maximum stop-loss ratio

If the value is 11.11, it represents 11.11%

maxStopSurplusRation
​string

Maximum take-profit ratio

If the value is 11.11, it represents 11.11%

maxTraceAmount
​string

Maximum copy trading volume (single order)

maxTraceAmountSystem
​string

System configuration for the maximum buying amount

maxTraceSize
​string

Maximum amount for copy trading

maxTraceRation
​string

Maximum copy trade ratio

(2 decimal places, e.g. 0.11 for 11%)

If the value is 11.11, it represents 11.11%

minStopLossRation
​string

Minimum stop-loss ratio

(2 decimal places, e.g. 0.11 for 11%)

If the value is 11.11, it represents 11.11%

minStopSurplusRation
​string

Minimum take-profit ratio

If the value is 11.11, it represents 11.11%

minTraceAmount
​string

Minimum copy trading volume

minTraceSize
​string

Minimum copy trade volume

minTraceRation
​string

Minimum order ratio

sliderMaxStopLossRatio
​string

Maximum stop loss ratio of slider

sliderMaxStopSurplusRatio
​string

Maximum take-profit ratio of slider

symbol
​string

Trading pair

endId
​string

The last data id. The id value is the tracking number, used to query based on id

GET/api/v2/copy/spot-follower/query-settings
curl 'https://api.bitget.com/api/v2/copy/spot-follower/query-settings?traderId=<string>'
Example Responses
{ "code": "00000", "data": { "enable": "YES", "profitRate": "5", "settledInDays": "53", "tradeSettingList": [ { "maxTraceAmount": "50000", "stopLossRation": "10", "stopSurplusRation": "10", "symbol": "ETHUSDT", "traceType": "FIXED_AMOUNT" } ], "tradeSymbolSettingList": [ { "maxStopLossRation": "90", "maxStopSurplusRation": "500", "maxTraceAmount": "1200", "maxTraceAmountSystem": "50000", "maxTraceSize": "500", "maxTraceRation": "20", "minStopLossRation": "0", "minStopSurplusRation": "0", "minTraceAmount": "10", "minTraceSize": "0.001", "minTraceRation": "0.1", "sliderMaxStopLossRatio": "90", "sliderMaxStopSurplusRatio": "500", "symbol": "BTCUSDT" } ], "traderHeadPic": "", "traderName": "139****0981" }, "msg": "success", "requestTime": 1682401856339 }
json
application/json

Get Trader's Current Trading Pair

GET
https://api.bitget.com
/api/v2/copy/spot-follower/query-trader-symbols

Limit rule 10 times/1s (uid)

Get Trader's Current Trading Pair › Request Parameters

traderId
​string · required

trader Id

Get Trader's Current Trading Pair › Response Parameters

200

Successful response

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

Current copy trading pairs

GET/api/v2/copy/spot-follower/query-trader-symbols
curl 'https://api.bitget.com/api/v2/copy/spot-follower/query-trader-symbols?traderId=<string>'
Example Responses
{ "code": "00000", "data": { "currentTradingList": [ "ETHUSDT", "BTCUSDT" ] }, "msg": "success", "requestTime": 1627354109502 }
json
application/json

My Trader List

GET
https://api.bitget.com
/api/v2/copy/spot-follower/query-traders

Rate Limit: 5 req/sec/UID

My Trader List › Request Parameters

pageNo
​string

pageNo (default 1)

pageSize
​string

The default is 20, and the maximum supported is 50.

startTime
​string

start Time

endTime
​string

end Time

My Trader List › Response Parameters

200

Successful response

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

Trader list

certificationType
​string

Certification type

uncertified

certified

traceTotalAmount
​string

Cumulative position opening value in USDT

traceTotalNetProfit
​string

Net profit in USDT

traceTotalProfit
​string

Total profit in USDT

traderName
​string

trader nick name

traderId
​string

trader Id

maxFollowLimit
​string

Maximum number of followers

bgbMaxFollowLimit
​string

Maximum number of followers granted by BGB holdings

followCount
​string

Number of current followers

bgbFollowCount
​string

Number of followers granted by BGB holdings

followerTime
​string

Following date (take the first following date)

Milliseconds format of timestamp Unix, e.g. 1597026383085

GET/api/v2/copy/spot-follower/query-traders
curl https://api.bitget.com/api/v2/copy/spot-follower/query-traders
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695813674738, "data": { "resultList": [ { "certificationType": "Uncertified", "traceTotalAmount": "16027.6543", "traceTotalNetProfit": "43.2480", "traceTotalProfit": "52.8743", "traderName": "BGU***9Z72", "traderId": "**********", "maxFollowLimit": "300", "bgbMaxFollowLimit": "", "followCount": "1", "bgbFollowCount": "", "followerTime": "1693533344295" } ] } }
json
application/json

Set Take Profit And Stop Loss

POST
https://api.bitget.com
/api/v2/copy/spot-follower/setting-tpsl

Rate Limit: 1 req/sec/UID

Set Take Profit And Stop Loss › Request Parameters

trackingNo
​string · required

tracking Order number

stopSurplusPrice
​string

One of stopSurplusPrice and stopLossPrice must be passed.

TP price

When it is empty, it is ignored or not updated, no matter take-profit exists or not,

When it is 0, it means the original take-profit is canceled if there is a take-profit already.

When it is greater than or equal to 0, it means take-profit is updated or set.

stopLossPrice
​string

One of stopSurplusPrice and stopLossPrice must be passed.

SL price

When it is empty, it is ignored or not updated, no matter stop-loss exists or not,

When it is 0, it means the original stop-loss is canceled if there is a stop-loss already.

When it is greater than or equal to 0, it means stop-loss is updated or set.

Set Take Profit And Stop Loss › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
data
​string

Result

success Success

others fail

POST/api/v2/copy/spot-follower/setting-tpsl
curl https://api.bitget.com/api/v2/copy/spot-follower/setting-tpsl \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "trackingNo": "trackingNo", "stopSurplusPrice": "stopSurplusPrice", "stopLossPrice": "stopLossPrice" }'
Example Request Body
{ "trackingNo": "trackingNo", "stopSurplusPrice": "stopSurplusPrice", "stopLossPrice": "stopLossPrice" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json

Add or Modify Following Configurations

POST
https://api.bitget.com
/api/v2/copy/spot-follower/settings

Rate Limit: 1 req/sec/UID

Add or Modify Following Configurations › Request Parameters

traderId
​string · required

Trader user ID

​object[] · required

settings

symbol
​string · required

Trading pair

traceType
​string · required

Copy trade type

percent Set the percentage of the copy trade amount to the trader's elite trade amount. For example, 1 means the follower invests the same amount to open a position as the elite trader, and 2 means the follower invests twice the amount of the elite trader.

amount The fixed volume specified for copy trading

count Number of copy trade orders with fixed volume (only take effect when parameter mode is advanced)

maxHoldSize
​string · required

Maximum following buying quantity

traceValue
​string · required

Copy trade investment amount

100 or 0.1

TraceType parameter corresponding to the value

stopLossRatio
​string

The stop-loss ratio can only be a positive integer. 10 means 10%.

stopSurplusRatio
​string

The take-profit ratio can only be a positive integer. 10 means 10%.

autoCopy
​string

Whether to automatically follow new symbol opened by traders(only take effect when parameter mode is basic)

on:auto

off:no

mode
​string

follow mode

basic:basic mode

advanced(default):advanced mode

Add or Modify Following Configurations › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
data
​string

Result

success Success

others fail

POST/api/v2/copy/spot-follower/settings
curl https://api.bitget.com/api/v2/copy/spot-follower/settings \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "traderId": "traderId", "autoCopy": "autoCopy", "mode": "mode", "settings": [ { "symbol": "symbol", "traceType": "traceType", "maxHoldSize": "maxHoldSize", "traceValue": "traceValue", "stopLossRatio": "stopLossRatio", "stopSurplusRatio": "stopSurplusRatio" } ] }'
Example Request Body
{ "traderId": "traderId", "autoCopy": "autoCopy", "mode": "mode", "settings": [ { "symbol": "symbol", "traceType": "traceType", "maxHoldSize": "maxHoldSize", "traceValue": "traceValue", "stopLossRatio": "stopLossRatio", "stopSurplusRatio": "stopSurplusRatio" } ] }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json

Stop The Order

POST
https://api.bitget.com
/api/v2/copy/spot-follower/stop-order

Rate Limit: 1 req/sec/UID

Stop The Order › Request Parameters

trackingNoList
​string[] · required

Order tracking number groups

Up to 50.

Atomic execution results, either all successful or all failed.

Stop The Order › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
data
​string

Result

success Success

others fail

POST/api/v2/copy/spot-follower/stop-order
curl https://api.bitget.com/api/v2/copy/spot-follower/stop-order \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "trackingNoList": [ "string" ] }'
Example Request Body
{ "trackingNoList": [ "string" ] }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json