跟单 · 现货跟单 · 跟单员

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

查询当前跟单信息

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[]

跟单集合

trackingNo

string

跟踪订单号

traderId

string

交易员uid

buyFillSize

string

买入成交数量

buyDelegateSize

string

买入委托数量

buyPrice

string

买入价格

unrealizedPL

string

当前未实现盈亏

buyTime

string

买入时间

buyFee

string

买入手续费

unrealizedPLR

string

当前未实现盈亏收益率,若值为11.11，则代表11.11%

symbol

string

交易对

stopSurplusPrice

string

止盈价格

stopLossPrice

string

止损价格

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[]

跟单集合

trackingNo

string

跟踪订单号

traderId

string

交易员uid

fillSize

string

成交数量

buyPrice

string

买入价格

sellPrice

string

卖出均价

achievedPL

string

已实现盈亏收益

buyTime

string

买入时间

sellTime

string

卖出时间

buyFee

string

买入手续费

sellFee

string

卖出手续费

achievedPLR

string

已实现盈亏收益率若值为11.11，则代表11.11%

symbol

string

交易对

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[]

我的跟单设置

maxTraceAmount

string

最大跟随买入金（右币）

stopLossRation

string

止损比例

stopSurplusRation

string

止盈比例

symbol

string

币对ID

traceType

string

跟单类型

percent 设置跟单金额对交易员开仓金额的比例，例如1，则表示跟交易员开仓金额相同，2表示开仓金额是交易员开仓金额的2倍;

amount 跟单金额指定固定金额;

count 跟单金额固定张数;

object[]

币对跟单配置

maxStopLossRation

string

最大止损比例

maxStopSurplusRation

string

最大止盈比例

maxTraceAmount

string

最大跟单金额（单次）

maxTraceAmountSystem

string

最大买入数量限制系统配置

maxTraceSize

string

最大跟单数量

maxTraceRation

string

最大跟单比例

minStopLossRation

string

最小止损比例

minStopSurplusRation

string

最小止盈比例

minTraceAmount

string

最小跟单金额

minTraceSize

string

最小跟单数量

minTraceRation

string

最小跟单比例

sliderMaxStopLossRatio

string

滑竿最大止损比例

sliderMaxStopSurplusRatio

string

滑竿最大止盈比例

symbol

string

交易对

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[]

交易员列表

certificationType

string

认证类型

traceTotalAmount

string

累计开仓价值 , USDT

traceTotalNetProfit

string

净收益 , USDT

traceTotalProfit

string

累计总收益 , USDT

traderName

string

交易员昵称

traderId

string

交易员ID

maxFollowLimit

string

最大可跟人数

bgbMaxFollowLimit

string

bgb特殊跟随最大可跟人数

followCount

string

当前已跟人数

bgbFollowCount

string

bgb特殊跟随当前已跟人数

followerTime

string

跟随日期（以初次跟随日期为准）

Unix时间戳的毫秒数格式，如 1597026383085

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

POST

https://api.bitget.com

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

限速规则: 1次/秒/UID

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

traderId

string · required

交易员ID

object[] · required

配置

symbol

string · required

交易币对

traceType

string · required

跟单类型

percent 设置跟单金额对交易员开仓金额的比例，例如1，则表示跟交易员开仓金额相同，2表示开仓金额是交易员开仓金额的2倍;

amount 跟单金额指定固定金额;

count 跟单金额固定张数(mode参数为advanced高级模式才生效);

maxHoldSize

string · required

最大跟随买入数量

traceValue

string · required

跟投值

stopLossRatio

string

止损比例只能整数 10 代表 10%

stopSurplusRatio

string

止盈比例只能整数 10 代表 10%

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[]

跟单集合

trackingNo

string

跟踪订单号

traderId

string

交易员uid

buyFillSize

string

买入成交数量

buyDelegateSize

string

买入委托数量

buyPrice

string

买入价格

unrealizedPL

string

当前未实现盈亏

buyTime

string

买入时间

buyFee

string

买入手续费

unrealizedPLR

string

当前未实现盈亏收益率,若值为11.11，则代表11.11%

symbol

string

交易对

stopSurplusPrice

string

止盈价格

stopLossPrice

string

止损价格

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[]

跟单集合

trackingNo

string

跟踪订单号

traderId

string

交易员uid

fillSize

string

成交数量

buyPrice

string

买入价格

sellPrice

string

卖出均价

achievedPL

string

已实现盈亏收益

buyTime

string

买入时间

sellTime

string

卖出时间

buyFee

string

买入手续费

sellFee

string

卖出手续费

achievedPLR

string

已实现盈亏收益率若值为11.11，则代表11.11%

symbol

string

交易对

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[]

我的跟单设置

maxTraceAmount

string

最大跟随买入金（右币）

stopLossRation

string

止损比例

stopSurplusRation

string

止盈比例

symbol

string

币对ID

traceType

string

跟单类型

percent 设置跟单金额对交易员开仓金额的比例，例如1，则表示跟交易员开仓金额相同，2表示开仓金额是交易员开仓金额的2倍;

amount 跟单金额指定固定金额;

count 跟单金额固定张数;

object[]

币对跟单配置

maxStopLossRation

string

最大止损比例

maxStopSurplusRation

string

最大止盈比例

maxTraceAmount

string

最大跟单金额（单次）

maxTraceAmountSystem

string

最大买入数量限制系统配置

maxTraceSize

string

最大跟单数量

maxTraceRation

string

最大跟单比例

minStopLossRation

string

最小止损比例

minStopSurplusRation

string

最小止盈比例

minTraceAmount

string

最小跟单金额

minTraceSize

string

最小跟单数量

minTraceRation

string

最小跟单比例

sliderMaxStopLossRatio

string

滑竿最大止损比例

sliderMaxStopSurplusRatio

string

滑竿最大止盈比例

symbol

string

交易对

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[]

交易员列表

certificationType

string

认证类型

traceTotalAmount

string

累计开仓价值 , USDT

traceTotalNetProfit

string

净收益 , USDT

traceTotalProfit

string

累计总收益 , USDT

traderName

string

交易员昵称

traderId

string

交易员ID

maxFollowLimit

string

最大可跟人数

bgbMaxFollowLimit

string

bgb特殊跟随最大可跟人数

followCount

string

当前已跟人数

bgbFollowCount

string

bgb特殊跟随当前已跟人数

followerTime

string

跟随日期（以初次跟随日期为准）

Unix时间戳的毫秒数格式，如 1597026383085

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

POST

https://api.bitget.com

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

限速规则: 1次/秒/UID

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

traderId

string · required

交易员ID

object[] · required

配置

symbol

string · required

交易币对

traceType

string · required

跟单类型

percent 设置跟单金额对交易员开仓金额的比例，例如1，则表示跟交易员开仓金额相同，2表示开仓金额是交易员开仓金额的2倍;

amount 跟单金额指定固定金额;

count 跟单金额固定张数(mode参数为advanced高级模式才生效);

maxHoldSize

string · required

最大跟随买入数量

traceValue

string · required

跟投值

stopLossRatio

string

止损比例只能整数 10 代表 10%

stopSurplusRatio

string

止盈比例只能整数 10 代表 10%

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[]

当前带单币对