跟单 · 现货跟单 · 跟单员

经典账户 — 跟单 · 现货跟单 · 跟单员

查询当前跟单信息

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-current-orders

限速规则: 5次/秒/UID

查询当前跟单信息 › Request Parameters

symbol

string

交易对

traderId

string

交易员id

idLessThan

string

请求此ID之前

idGreaterThan

string

请求此ID之后

startTime

string

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传结束时间，则默认结束时间为三个月。）

endTime

string

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传开始时间，则默认开始时间为三个月。）

limit

string

默认20条，最大支持50条。超过将返回20条

查询当前跟单信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟单集合

endId

string

最后的数据id。id值为跟踪单号，用于根据id查询

跟随者终止跟随

POST

https://api.bitget.com

/api/v2/copy/spot-follower/stop-order

限速规则: 1次/秒/UID

跟随者终止跟随 › Request Parameters

trackingNoList

string[] · required

跟单号列表

最多50个

要么全部成功，要么全部失败

跟随者终止跟随 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

查询历史跟单信息

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-history-orders

限速规则: 5次/秒/UID

查询历史跟单信息 › Request Parameters

symbol

string

交易对

traderId

string

交易员id

idLessThan

string

请求此ID之前

idGreaterThan

string

请求此ID之后

startTime

string

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传结束时间，则默认结束时间为三个月。）

endTime

string

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传开始时间，则默认开始时间为三个月。）

limit

string

默认20条，最大支持50条。超过将返回20条

查询历史跟单信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟单集合

endId

string

最后的数据id。id值为跟踪单号，用于根据id查询

设置止盈止损

POST

https://api.bitget.com

/api/v2/copy/spot-follower/setting-tpsl

限速规则: 1次/秒/UID

设置止盈止损 › Request Parameters

trackingNo

string · required

跟踪订单号

stopSurplusPrice

string

止盈价（为空时，不管存不存在止盈都忽略或不更新，为0时，若存在止盈则表示取消原有止盈。大于0时，则表示更新或设置止盈。）

stopLossPrice

string

止损价(为空时，不管存不存在止损都忽略或不更新，为0时，若存在止损则表示取消原有止损。大于0时，则表示更新或设置止损。)

设置止盈止损 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

卖出和批量卖出

POST

https://api.bitget.com

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

限速规则: 1次/秒/UID

卖出和批量卖出 › Request Parameters

trackingNoList

string[] · required

按买入币对分组trackingNo，全部成功或全部失败，跟踪订单号，最大50个

symbol

string · required

交易对

卖出和批量卖出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

跟随者查询跟随配置

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-settings

限速规则: 5次/秒/UID

跟随者查询跟随配置 › Request Parameters

traderId

string · required

交易员id

跟随者查询跟随配置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

enable

string

我是否在跟随, YES NO

profitRate

string

分润比例

settledInDays

string

交易员入驻天数(从他在平台注册开始)

traderHeadPic

string

交易员头像

traderName

string

交易员昵称

object[]

我的跟单设置

object[]

币对跟单配置

endId

string

最后的数据id。id值为跟踪单号，用于根据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

https://api.bitget.com

/api/v2/copy/spot-follower/query-traders

限速规则: 5次/秒/UID

我的交易员列表 › Request Parameters

pageNo

string

pageNo (default 1)

pageSize

string

默认为20条，最大支持50条。

startTime

string

开始时间

endTime

string

结束时间

我的交易员列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

交易员列表

跟随者新增或修改跟随配置

POST

https://api.bitget.com

/api/v2/copy/spot-follower/settings

限速规则: 1次/秒/UID

跟随者新增或修改跟随配置 › Request Parameters

traderId

string · required

交易员ID

object[] · required

配置

autoCopy

string

是否自动跟随交易员新开的新币对(只在普通模式生效)

on：自动跟随

off：不自动跟随

mode

string

跟单模式

basic：普通模式

advanced(默认值)：高级模式

跟随者新增或修改跟随配置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

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

取消跟随

POST

https://api.bitget.com

/api/v2/copy/spot-follower/cancel-trader

限速规则: 1次/秒/UID

取消跟随 › Request Parameters

traderId

string · required

交易员ID

取消跟随 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

查看交易员当前带单币对

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-trader-symbols

限速规则: 10次/1s (uid)

查看交易员当前带单币对 › Request Parameters

traderId

string · required

交易员ID

查看交易员当前带单币对 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

currentTradingList

string[]

当前带单币对

经典账户 · 现货跟单 · 跟单员 API

跟单 · 现货跟单 · 跟单员

经典账户 — 跟单 · 现货跟单 · 跟单员

查询当前跟单信息

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-current-orders

限速规则: 5次/秒/UID

查询当前跟单信息 › Request Parameters

symbol

string

交易对

traderId

string

交易员id

idLessThan

string

请求此ID之前

idGreaterThan

string

请求此ID之后

startTime

string

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传结束时间，则默认结束时间为三个月。）

endTime

string

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传开始时间，则默认开始时间为三个月。）

limit

string

默认20条，最大支持50条。超过将返回20条

查询当前跟单信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟单集合

endId

string

最后的数据id。id值为跟踪单号，用于根据id查询

跟随者终止跟随

POST

https://api.bitget.com

/api/v2/copy/spot-follower/stop-order

限速规则: 1次/秒/UID

跟随者终止跟随 › Request Parameters

trackingNoList

string[] · required

跟单号列表

最多50个

要么全部成功，要么全部失败

跟随者终止跟随 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

查询历史跟单信息

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-history-orders

限速规则: 5次/秒/UID

查询历史跟单信息 › Request Parameters

symbol

string

交易对

traderId

string

交易员id

idLessThan

string

请求此ID之前

idGreaterThan

string

请求此ID之后

startTime

string

开始时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传结束时间，则默认结束时间为三个月。）

endTime

string

结束时间戳

Unix时间戳的毫秒数格式，如 1597026383085（时间跨度最大支持三个月，若不传开始时间，则默认开始时间为三个月。）

limit

string

默认20条，最大支持50条。超过将返回20条

查询历史跟单信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟单集合

endId

string

最后的数据id。id值为跟踪单号，用于根据id查询

设置止盈止损

POST

https://api.bitget.com

/api/v2/copy/spot-follower/setting-tpsl

限速规则: 1次/秒/UID

设置止盈止损 › Request Parameters

trackingNo

string · required

跟踪订单号

stopSurplusPrice

string

止盈价（为空时，不管存不存在止盈都忽略或不更新，为0时，若存在止盈则表示取消原有止盈。大于0时，则表示更新或设置止盈。）

stopLossPrice

string

止损价(为空时，不管存不存在止损都忽略或不更新，为0时，若存在止损则表示取消原有止损。大于0时，则表示更新或设置止损。)

设置止盈止损 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

卖出和批量卖出

POST

https://api.bitget.com

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

限速规则: 1次/秒/UID

卖出和批量卖出 › Request Parameters

trackingNoList

string[] · required

按买入币对分组trackingNo，全部成功或全部失败，跟踪订单号，最大50个

symbol

string · required

交易对

卖出和批量卖出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

跟随者查询跟随配置

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-settings

限速规则: 5次/秒/UID

跟随者查询跟随配置 › Request Parameters

traderId

string · required

交易员id

跟随者查询跟随配置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

enable

string

我是否在跟随, YES NO

profitRate

string

分润比例

settledInDays

string

交易员入驻天数(从他在平台注册开始)

traderHeadPic

string

交易员头像

traderName

string

交易员昵称

object[]

我的跟单设置

object[]

币对跟单配置

endId

string

最后的数据id。id值为跟踪单号，用于根据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

https://api.bitget.com

/api/v2/copy/spot-follower/query-traders

限速规则: 5次/秒/UID

我的交易员列表 › Request Parameters

pageNo

string

pageNo (default 1)

pageSize

string

默认为20条，最大支持50条。

startTime

string

开始时间

endTime

string

结束时间

我的交易员列表 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

交易员列表

跟随者新增或修改跟随配置

POST

https://api.bitget.com

/api/v2/copy/spot-follower/settings

限速规则: 1次/秒/UID

跟随者新增或修改跟随配置 › Request Parameters

traderId

string · required

交易员ID

object[] · required

配置

autoCopy

string

是否自动跟随交易员新开的新币对(只在普通模式生效)

on：自动跟随

off：不自动跟随

mode

string

跟单模式

basic：普通模式

advanced(默认值)：高级模式

跟随者新增或修改跟随配置 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

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

取消跟随

POST

https://api.bitget.com

/api/v2/copy/spot-follower/cancel-trader

限速规则: 1次/秒/UID

取消跟随 › Request Parameters

traderId

string · required

交易员ID

取消跟随 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

string

执行结果

success 成功

其它值失败

查看交易员当前带单币对

GET

https://api.bitget.com

/api/v2/copy/spot-follower/query-trader-symbols

限速规则: 10次/1s (uid)

查看交易员当前带单币对 › Request Parameters

traderId

string · required

交易员ID

查看交易员当前带单币对 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

currentTradingList

string[]

当前带单币对