Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
接口文档
经典账户
    跟单 · 现货跟单 · 带单员
      我的跟随者列表get移除跟随者post获取当前带单get修改止盈止损post查询历史带单get卖出和批量卖出post查看数据指标统计get交易员分润汇总get查看历史分润明细get查看待分润明细get交易员查询带单设置get带单币对设置post
经典账户 · 现货跟单 · 带单员 API
经典账户 · 现货跟单 · 带单员 API

跟单 · 现货跟单 · 带单员

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


我的跟随者列表

GET
https://api.bitget.com
/api/v2/copy/spot-trader/config-query-followers

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

我的跟随者列表 › Request Parameters

pageNo
​string

pageNo (default 1)

pageSize
​string

pageSize(default 30 max 1000)

startTime
​string

开始时间戳

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

endTime
​string

结束时间戳

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

我的跟随者列表 › Response Parameters

200

Successful response

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

账户权益值

isRemove
​string

能否移除跟单用户

yes 是;no 否

followerHeadPic
​string

跟随者头像

followerName
​string

跟随者昵称

followerUid
​string

跟随者用户id

followerTime
​string

跟随日期(以初次跟随日期为准)

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

GET/api/v2/copy/spot-trader/config-query-followers
curl https://api.bitget.com/api/v2/copy/spot-trader/config-query-followers
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695807814833, "data": [ { "accountEquity": "1001711.2164", "isRemove": "NO", "followerHeadPic": null, "followerName": "BGU***1QK5", "followerUid": "*********", "followerTime": "1693533344295" } ] }
json
application/json

移除跟随者

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

限速规则: 1次/秒/UID

移除跟随者 › Request Parameters

followerUid
​string · required

跟随者 UID

移除跟随者 › Response Parameters

200

Successful response

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

结果

00000 成功

其它值 失败

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

获取当前带单

GET
https://api.bitget.com
/api/v2/copy/spot-trader/order-current-track

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

获取当前带单 › Request Parameters

symbol
​string

交易对

idLessThan
​string

请求此ID之前

idGreaterThan
​string

请求此ID之后

startTime
​string

开始时间戳

endTime
​string

结束时间戳

limit
​string

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

获取当前带单 › Response Parameters

200

Successful response

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

带单集合

endId
​string

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

GET/api/v2/copy/spot-trader/order-current-track
curl https://api.bitget.com/api/v2/copy/spot-trader/order-current-track
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695803899870, "data": { "endId": "1", "trackingList": [ { "trackingNo": "1", "orderId": "1", "buyFillSize": "0.0317", "buyDelegateSize": "0.0317190800000000", "buyPrice": "34870.7", "unrealizedPL": "-0.79530295", "buyTime": "1695729894873", "buyFee": "-0.00001908", "unrealizedPLR": "-0.07", "symbol": "BTCUSDT", "stopLossPrice": null, "stopSurplusPrice": null, "followCount": "1" } ] } }
json
application/json

修改止盈止损

POST
https://api.bitget.com
/api/v2/copy/spot-trader/order-modify-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

结果

00000 成功

其它值 失败

POST/api/v2/copy/spot-trader/order-modify-tpsl
curl https://api.bitget.com/api/v2/copy/spot-trader/order-modify-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

查询历史带单

GET
https://api.bitget.com
/api/v2/copy/spot-trader/order-history-track

限速规则: 5次/秒/UID

查询历史带单 › Request Parameters

idLessThan
​string

请求此ID之前(更旧的数据)的分页内容,传的值为对应接口的 endId。

idGreaterThan
​string

请求此ID之后(更新的数据)的分页内容,传的值为对应接口的 endId

startTime
​string

开始时间戳

(跟单创建时间)

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

(时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。)

endTime
​string

结束时间戳

(跟单创建时间)

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

(时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。)

limit
​string

查询条数 默认20,最大100

symbol
​string

交易币对

支持大小写

查询历史带单 › Response Parameters

200

Successful response

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

带单记录集合

endId
​string

最后的跟踪订单id。

指定idLessThan/idGreaterThan作为范围查询时以此为准。

GET/api/v2/copy/spot-trader/order-history-track
curl https://api.bitget.com/api/v2/copy/spot-trader/order-history-track
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695805248324, "data": { "endId": "1", "trackingList": [ { "trackingNo": "1", "fillSize": "0.0317", "buyPrice": "34869.2", "sellPrice": "34865.5", "achievedPL": "-0.78259", "buyTime": "1695728919902", "sellTime": "1695729885589", "buyFee": "-0.00001908", "sellFee": "-0.66314181", "achievedPLR": "-0.07", "symbol": "BTCUSDT", "netProfit": "-1.44573", "followCount": "1" } ] } }
json
application/json

卖出和批量卖出

POST
https://api.bitget.com
/api/v2/copy/spot-trader/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

结果

00000 成功

其它值 失败

POST/api/v2/copy/spot-trader/order-close-tracking
curl https://api.bitget.com/api/v2/copy/spot-trader/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
https://api.bitget.com
/api/v2/copy/spot-trader/order-total-detail

限速规则: 5次/秒/UID

查看数据指标统计 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
totalFollowerNum
​string

累计跟随人数

currentFollowerNum
​string

当前跟随人数

maxFollowerNum
​string

交易员最大可跟随人数

tradingOrderNum
​string

总开单数

totalpl
​string

总收益

(USDT)

gainNum
​string

盈利比数

lossNum
​string

亏损比数

totalEquity
​string

总权益

winRate
​string

胜率

​object[]

近一周收益率

​object[]

近30天收益率

​object[]

近一周收益

​object[]

近30天收益

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-summarys

限速规则: 5次/秒/UID

获取交易员分润基础信息和历史分润概览汇总。

交易员分润汇总 › Response Parameters

200

Successful response

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

交易员分润汇总信息

​object[]

分润列表

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

查看历史分润明细

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

限速规则: 5次/秒/UID

查看历史分润明细 › Request Parameters

idLessThan
​string

请求此ID之前(更旧的数据)的分页内容,传的值为对应接口的 endId。

idGreaterThan
​string

请求此ID之后(更新的数据)的分页内容,传的值为对应接口的 endId

startTime
​string

开始时间戳

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

(时间跨度最大支持三个月,若不传结束时间,则默认结束时间为三个月。)

endTime
​string

结束时间戳

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

(时间跨度最大支持三个月,若不传开始时间,则默认开始时间为三个月。)

limit
​string

查询条数 默认100,最大100

coin
​string

分润结算币种

查看历史分润明细 › Response Parameters

200

Successful response

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

分润集合

endId
​string

最后的跟分润id。

指定idLessThan/idGreaterThan作为范围查询时以此为准。

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": "2", "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
https://api.bitget.com
/api/v2/copy/spot-trader/profit-details

限速规则: 5次/秒/UID

查看待分润明细 › Request Parameters

coin
​string

分润结算币种

pageNo
​string

当前页号

默认为1.

pageSize
​string

查询数量

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

查看待分润明细 › Response Parameters

200

Successful response

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

分润比例

如为11.11 则代表为11.11%

profit
​string

收益

coin
​string

结算币种

followerName
​string

跟单员昵称

GET/api/v2/copy/spot-trader/profit-details
curl https://api.bitget.com/api/v2/copy/spot-trader/profit-details
Example Responses
{ "code": "00000", "data": [ { "distributeRatio": "11.11", "coin": "usdt", "profit": "0", "followerName": "bitget" } ], "msg": "success", "requestTime": 1627354109502 }
json
application/json

交易员查询带单设置

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

限速规则: 5次/秒/UID

交易员查询带单设置 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
removeLimitUsdt
​string

可以移除跟随者资产上限。

(小于该值的跟随者能够被移除)

​object[]

带单额度集合

​object[]

标签集合

enable
​string

是否开启带单

yes 开启;no 关闭

showAssetsMap
​string

是否展示构成资产图表

yes 开启;no 关闭

showEquity
​string

是否展示总资金

yes 开启;no 关闭

​object[]

带单币对集合

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

带单币对设置

POST
https://api.bitget.com
/api/v2/copy/spot-trader/config-setting-symbols

限速规则: 1次/秒/UID

带单币对设置 › Request Parameters

symbolList
​string[] · required

带单币对集合

最大50个

settingType
​string · required

设置类型

add 新增;

delete 删除;

带单币对设置 › Response Parameters

200

Successful response

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

结果

00000 成功

其它值 失败

POST/api/v2/copy/spot-trader/config-setting-symbols
curl https://api.bitget.com/api/v2/copy/spot-trader/config-setting-symbols \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "symbolList": [ "string" ], "settingType": "settingType" }'
Example Request Body
{ "symbolList": [ "string" ], "settingType": "settingType" }
json
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1656066841304, "data": "" }
json
application/json