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

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

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

endId

string

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

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

endId

string

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

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

object[]

Trading pair copy trading configuration

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

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

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

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

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

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

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

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

endId

string

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

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

endId

string

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

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

object[]

Trading pair copy trading configuration

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

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

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

stopLossPrice

string

Set Take Profit And Stop Loss › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result success Success others fail

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

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