Copy Trading · Spot Copy · Trader

Classic Account — Copy Trading · Spot Copy · Trader

My Follower List

GET

https://api.bitget.com

/api/v2/copy/spot-trader/config-query-followers

Limit rule 10 times/1s (uid)

My Follower List › Request Parameters

pageNo

string

pageNo (default 1)

pageSize

string

pageSize(default 30 max 1000)

startTime

string

start time

endTime

string

end time

My Follower List › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

accountEquity

string

Account asset value

isRemove

string

Is it able to remove followers?

yes: yes; no: no

followerHeadPic

string

Follower avatar

followerName

string

Follower Nickname

followerUid

string

Follower user id

followerTime

string

Following date (take the first following date)

Unix timestamp in milliseconds format, e.g. 1597026383085

Get Copytrade Configuration

GET

https://api.bitget.com

/api/v2/copy/spot-trader/config-query-settings

Rate Limit: 5 req/sec/UID

Get Copytrade Configuration › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

removeLimitUsdt

string

The maximum limit of follower assets can be removed.

(followers with the assets less than this value can be removed)

object[]

Overview of elite trade amount

maxQuoteSize

string

Maximum single order amount (price currency)

surplusQuoteSize

string

Remaining amount (price currency)

symbol

string

symbol

object[]

Tag overview

id

string

tag id

name

string

tag name

enable

string

Activate elite trading or not?

yes: on; no: off

showAssetsMap

string

Display composition of assets or not?

yes: on; no: off

showEquity

string

Display total funds or not?

yes: on; no: off

object[]

Overview of trading pairs for elite trades

enable

string

Is this trading pair open for elite trades?

yes: on; no: off

symbol

string

Trading pair

minOpenCount

string

Minimum number of elite trades for elite traders

GET/api/v2/copy/spot-trader/config-query-settings

curl https://api.bitget.com/api/v2/copy/spot-trader/config-query-settings

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695807020372,
  "data": {
    "removeLimitUsdt": "100",
    "spotInfoList": [
      {
        "maxQuoteSize": "5000000",
        "surplusQuoteSize": "4998894.59",
        "symbol": "BTCUSDT"
      },
      {
        "maxQuoteSize": "300000",
        "surplusQuoteSize": "300000",
        "symbol": "ETHBTC"
      },
      {
        "maxQuoteSize": "50000",
        "surplusQuoteSize": "50000",
        "symbol": "ETHUSDT"
      }
    ],
    "labelList": [],
    "enable": "YES",
    "showAssetsMap": "NO",
    "showEquity": "NO",
    "traceSymbolList": [
      {
        "enable": "NO",
        "symbol": "BGBUSDT",
        "minOpenCount": "0.0001"
      },
      {
        "enable": "YES",
        "symbol": "BTCUSDT",
        "minOpenCount": "0.0005"
      },
      {
        "enable": "YES",
        "symbol": "ETHBTC",
        "minOpenCount": "0.0001"
      },
      {
        "enable": "YES",
        "symbol": "ETHUSDT",
        "minOpenCount": "0.0001"
      }
    ]
  }
}

json

application/json

Remove Followers

POST

https://api.bitget.com

/api/v2/copy/spot-trader/config-remove-follower

Rate Limit: 1 req/sec/UID

Remove Followers › Request Parameters

followerUid

string · required

Follower UID

Remove Followers › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result code

00000success

others fail

Set Copytrade Symbols

POST

https://api.bitget.com

/api/v2/copy/spot-trader/config-setting-symbols

Rate Limit: 1 req/sec/UID

Set Copytrade Symbols › Request Parameters

symbolList

string[] · required

Collection with single currency pairs

Maximum 50

settingType

string · required

Setting type

add new;

delete delete;

Set Copytrade Symbols › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result code

00000success

others fail

Sell And Sell in Batch

POST

https://api.bitget.com

/api/v2/copy/spot-trader/order-close-tracking

Rate Limit: 1 req/sec/UID

Sell And Sell in Batch › Request Parameters

trackingNoList

string[] · required

Categorizing trackingNo by buying trading pairs

All success or all fail, track order number, maximum: 50

symbol

string · required

Trading pair

Sell And Sell in Batch › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result code

00000success

others fail

Get Current Tracking Orders

GET

https://api.bitget.com

/api/v2/copy/spot-trader/order-current-track

Limit rule 10 times/1s (uid)

Get Current Tracking Orders › Request Parameters

symbol

string

Trading pair

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, and the maximum supported is 50. More than 20 items will be returned

Get Current Tracking Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

tracking order collection

trackingNo

string

Track order number

orderId

string

order number

buyFillSize

string

Number of filled buy orders

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

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

symbol

string

Trading pair

stopLossPrice

string

Stop loss price

stopSurplusPrice

string

Take profit price

followCount

string

Number of followers for this order

endId

string

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

Get History Tracking Orders

GET

https://api.bitget.com

/api/v2/copy/spot-trader/order-history-track

Rate Limit: 5req/sec/UID

Get History Tracking Orders › Request Parameters

idLessThan

string

Request the paging content before this ID (older data), and the passed value is the endId of the corresponding interface.

idGreaterThan

string

Request the paging content after this ID (updated data). The value passed is the endId of the corresponding interface.

startTime

string

start time

endTime

string

end time

limit

string

Number of queries: Default 20, maximum 100

symbol

string

symbol

Get History Tracking Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Overview of elite trade records

trackingNo

string

Track order number

fillSize

string

Filled quantity

buyPrice

string

buy price

sellPrice

string

sell 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

netProfit

string

Net profit (negative value presents a loss)

followCount

string

Number of followers for this order

endId

string

The last tracking order id.

This shall prevail when specifying idLessThan/idGreaterThan as the range query

Modify Take Profit and Stop Loss

POST

https://api.bitget.com

/api/v2/copy/spot-trader/order-modify-tpsl

Rate Limit: 1 req/sec/UID

Modify Take Profit and Stop Loss › Request Parameters

trackingNo

string · required

Track 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.

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.

Modify Take Profit and Stop Loss › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

Result code

00000success

others fail

Get Data Indicator Statistics

GET

https://api.bitget.com

/api/v2/copy/spot-trader/order-total-detail

Rate Limit: 5 req/sec/UID

Get Data Indicator Statistics › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

totalFollowerNum

string

Total followers

currentFollowerNum

string

Current number of followers

maxFollowerNum

string

Maximum number of followers for the elite trader

tradingOrderNum

string

Total opening orders

totalpl

string

Total profit

(USDT)

gainNum

string

Ratio of profitable trades

lossNum

string

Ratio of losing trades

totalEquity

string

Total assets

winRate

string

Win rate

object[]

ROI for the last week

rate

string

rate

ctime

string

time

object[]

30-day ROI

rate

string

rate

ctime

string

time

object[]

Profit for the last week

amount

string

amount, USDT

ctime

string

time

object[]

30-day Profit

amount

string

amount, USDT

ctime

string

time

GET/api/v2/copy/spot-trader/order-total-detail

curl https://api.bitget.com/api/v2/copy/spot-trader/order-total-detail

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806393920,
  "data": {
    "totalFollowerNum": "1",
    "currentFollowerNum": "1",
    "maxFollowerNum": "300",
    "tradingOrderNum": "20",
    "totalpl": "180.81650415",
    "gainNum": "9",
    "lossNum": "11",
    "totalEquity": "1002283.204381698640000000",
    "winRate": "10.00",
    "lastWeekRoiList": [
      {
        "rate": "14.08",
        "ctime": "1695139200000"
      },
      {
        "rate": "14.08",
        "ctime": "1695225600000"
      },
      {
        "rate": "16.84",
        "ctime": "1695312000000"
      },
      {
        "rate": "16.84",
        "ctime": "1695398400000"
      },
      {
        "rate": "16.84",
        "ctime": "1695484800000"
      },
      {
        "rate": "16.84",
        "ctime": "1695571200000"
      },
      {
        "rate": "16.84",
        "ctime": "1695657600000"
      },
      {
        "rate": "16.84",
        "ctime": "1695744000000"
      }
    ],
    "lastMonthRoiList": [
      {
        "rate": "0",
        "ctime": "1693152000000"
      },
      {
        "rate": "0",
        "ctime": "1693238400000"
      },
      {
        "rate": "0",
        "ctime": "1693324800000"
      },
      {
        "rate": "-0.06",
        "ctime": "1693411200000"
      },
      {
        "rate": "14.14",
        "ctime": "1693497600000"
      },
      {
        "rate": "14.14",
        "ctime": "1693584000000"
      },
      {
        "rate": "14.14",
        "ctime": "1693670400000"
      },
      {
        "rate": "14.08",
        "ctime": "1693756800000"
      },
      {
        "rate": "14.08",
        "ctime": "1693843200000"
      },
      {
        "rate": "14.08",
        "ctime": "1693929600000"
      },
      {
        "rate": "14.08",
        "ctime": "1694016000000"
      },
      {
        "rate": "14.08",
        "ctime": "1694102400000"
      },
      {
        "rate": "14.08",
        "ctime": "1694188800000"
      },
      {
        "rate": "14.08",
        "ctime": "1694275200000"
      },
      {
        "rate": "14.08",
        "ctime": "1694361600000"
      },
      {
        "rate": "14.08",
        "ctime": "1694448000000"
      },
      {
        "rate": "14.08",
        "ctime": "1694534400000"
      },
      {
        "rate": "14.08",
        "ctime": "1694620800000"
      },
      {
        "rate": "14.08",
        "ctime": "1694707200000"
      },
      {
        "rate": "14.08",
        "ctime": "1694793600000"
      },
      {
        "rate": "14.08",
        "ctime": "1694880000000"
      },
      {
        "rate": "14.08",
        "ctime": "1694966400000"
      },
      {
        "rate": "14.08",
        "ctime": "1695052800000"
      },
      {
        "rate": "14.08",
        "ctime": "1695139200000"
      },
      {
        "rate": "14.08",
        "ctime": "1695225600000"
      },
      {
        "rate": "16.84",
        "ctime": "1695312000000"
      },
      {
        "rate": "16.84",
        "ctime": "1695398400000"
      },
      {
        "rate": "16.84",
        "ctime": "1695484800000"
      },
      {
        "rate": "16.84",
        "ctime": "1695571200000"
      },
      {
        "rate": "16.84",
        "ctime": "1695657600000"
      },
      {
        "rate": "16.84",
        "ctime": "1695744000000"
      }
    ],
    "lastWeekProfitList": [
      {
        "amount": "156.403443",
        "ctime": "1695139200000"
      },
      {
        "amount": "156.403443",
        "ctime": "1695225600000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695312000000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695398400000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695484800000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695571200000"
      },
      {
        "amount": "180.816504",
        "ctime": "1695657600000"
      },
      {
        "amount": "180.816504",
        "ctime": "1695744000000"
      }
    ],
    "lastMonthProfitList": [
      {
        "amount": "-0.703906",
        "ctime": "1695139200000"
      },
      {
        "amount": "-0.703906",
        "ctime": "1695225600000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695312000000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695398400000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695484800000"
      },
      {
        "amount": "187.067143",
        "ctime": "1695571200000"
      },
      {
        "amount": "180.816504",
        "ctime": "1695657600000"
      },
      {
        "amount": "180.816504",
        "ctime": "1695744000000"
      }
    ]
  }
}

json

application/json

GET

https://api.bitget.com

/api/v2/copy/spot-trader/profit-details

Rate Limit: 5 req/sec/UID

coin

string

Settlement currency of profit share

pageNo

string

page no

pageSize

string

The number of queries

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

200

Successful response

code

string

msg

string

requestTime

integer

object[]

distributeRatio

string[]

Profit share ratio

If the value is 11.11, it represents 11.11%

profit

string

PnL

coin

string

Settlement currency

followerName

string

Elite trader alias

GET

https://api.bitget.com

/api/v2/copy/spot-trader/profit-history-details

Rate Limit: 5 req/sec/UID

idLessThan

string

Request the paging content before this ID (older data), and the passed value is the endId of the corresponding interface.

idGreaterThan

string

Request the paging content after this ID (updated data). The value passed is the endId of the corresponding interface.

startTime

string

start time

endTime

string

end time

limit

string

Number of queries: Default 100, maximum 100

coin

string

Profit sharing settlement currency

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Profit share overview

profitId

string

Profit share ID

coin

string

Settlement currency

distributeRatio

string

Profit share ratio

If the value is 11.11, it represents 11.11%

profit

string

PnL

followerName

string

Elite trader alias

profitTime

string

Time to distribute profit share

endId

string

The last profit share ID.

This is used when idLessThan/idGreaterThan is set as the querying scope.

GET/api/v2/copy/spot-trader/profit-history-details

curl https://api.bitget.com/api/v2/copy/spot-trader/profit-history-details

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806800430,
  "data": {
    "endId": "4",
    "profitList": [
      {
        "profitId": "1",
        "coin": "USDT",
        "distributeRatio": "8",
        "profit": "2.40377986",
        "followerName": "xx1",
        "profitTime": "1695371100000"
      },
      {
        "profitId": "2",
        "coin": "USDT",
        "distributeRatio": "8",
        "profit": "0.00000000",
        "followerName": "xx2",
        "profitTime": "1693822200000"
      },
      {
        "profitId": "3",
        "coin": "USDT",
        "distributeRatio": "8",
        "profit": "0.01625000",
        "followerName": "xx3",
        "profitTime": "1693556100000"
      },
      {
        "profitId": "4",
        "coin": "USDT",
        "distributeRatio": "8",
        "profit": "2.16373741",
        "followerName": "xx4",
        "profitTime": "1693536000000"
      }
    ]
  }
}

json

application/json

Get Profit Summary

GET

https://api.bitget.com

/api/v2/copy/spot-trader/profit-summarys

Rate Limit: 5 req/sec/UID

Get basic information on traders' profits and a summary of historical profits.

Get Profit Summary › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

Elite trader profit share overview

yesterdayProfit

string

Yesterday's profit share (elite traders)

yesterdayTime

string

Yesterday's profit sharing time (milliseconds)

sumProfit

string

Profit share in total

waitProfit

string

To be shared

object[]

Profit list

coin

string

Settlement currency

(in cryptocurrency)

profitCount

string

Profit overview

(in cryptocurrency)

lastProfitTime

string

The last time to distribute profit share (milliseconds)

(in cryptocurrency)

object[]

Historical profit share overview

(in the dimension of the cryptocurrency and the date)

profit

string

PnL

(in the dimension of the cryptocurrency and the date)

profitTime

string

Time to distribute profit share (milliseconds)

(in the dimension of the cryptocurrency and the date)

GET/api/v2/copy/spot-trader/profit-summarys

curl https://api.bitget.com/api/v2/copy/spot-trader/profit-summarys

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806592362,
  "data": {
    "profitSummarys": {
      "yesterdayProfit": "0",
      "yesterdayTime": "1695720000000",
      "sumProfit": "4.5837",
      "waitProfit": "0"
    },
    "profitHistoryList": [
      {
        "coin": "USDT",
        "profitCount": "4.58376728",
        "lastProfitTime": "1695371160000",
        "historysByDateList": [
          {
            "profit": "2.40377986",
            "profitTime": "1695371100000"
          },
          {
            "profit": "0.01625000",
            "profitTime": "1693556100000"
          },
          {
            "profit": "2.16373741",
            "profitTime": "1693536000000"
          }
        ]
      }
    ]
  }
}

json

application/json

Copy Trading · Spot Copy · Trader

My Follower List

My Follower List › Request Parameters

My Follower List › Response Parameters

Get Copytrade Configuration

Get Copytrade Configuration › Response Parameters

Remove Followers

Remove Followers › Request Parameters

Remove Followers › Response Parameters

Set Copytrade Symbols

Set Copytrade Symbols › Request Parameters

Set Copytrade Symbols › Response Parameters

Sell And Sell in Batch

Sell And Sell in Batch › Request Parameters

Sell And Sell in Batch › Response Parameters

Get Current Tracking Orders

Get Current Tracking Orders › Request Parameters

Get Current Tracking Orders › Response Parameters

Get History Tracking Orders

Get History Tracking Orders › Request Parameters

Get History Tracking Orders › Response Parameters

Modify Take Profit and Stop Loss

Modify Take Profit and Stop Loss › Request Parameters

Modify Take Profit and Stop Loss › Response Parameters

Get Data Indicator Statistics

Get Data Indicator Statistics › Response Parameters

Get Unrealized Profit Sharing Details

Get Unrealized Profit Sharing Details › Request Parameters

Get Unrealized Profit Sharing Details › Response Parameters

Get History Profit Sharing Details

Get History Profit Sharing Details › Request Parameters

Get History Profit Sharing Details › Response Parameters

Get Profit Summary

Get Profit Summary › Response Parameters