合约公域/私域

获取仓位汇总

GET

https://api.bitget.com

/api/v3/copy/futures/position-summary

限频规则: 5次/秒/UID

权限: 统一账户 — 合约带单持仓 — 只读

获取仓位汇总

获取仓位汇总 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

unrealizedPnl

string

未实现盈亏单位：USDT

realizedPnl

string

已实现盈亏单位：USDT

holdSize

string

持仓数量

avgPrice

string

持仓均价

symbol

string

交易对名称

leverage

string

杠杆倍数正整数

marginMode

string

保证金模式： isolated 逐仓 cross 全仓

liqPrice

string

强平价格

margin

string

保证金

holdSide

string

持仓方向： long 多仓 short 空仓

roi

string

回报率

markPrice

string

标记价格

positionValue

string

仓位价值单位：USDT

获取带单币对信息

GET

https://api.bitget.com

/api/v3/copy/futures/trading-pairs

限频规则: 5次/秒/UID

权限: 统一账户 — 合约带单订单 — 只读

获取带单币对信息

获取带单币对信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

leverage

string

杠杆倍数

object[]

保证金明细列表

带单账户最大可转出

GET

https://api.bitget.com

/api/v3/copy/futures/max-transferable

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的最大可转出金额及可用余额。

带单账户最大可转出 › Request Parameters

coin

string · required

币种名称，例如 USDT

带单账户最大可转出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

maxTransferable

string

最大可转出金额

available

string

可用余额

带单账户划转

POST

https://api.bitget.com

/api/v3/copy/futures/transfer

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单读写权限

将资金转入或转出带单账户。仅支持现货账户（经典）/资金账户（统一）与带单账户之间的划转。

带单账户划转 › Request Parameters

type

string · required

划转类型 in 转入（现货/资金账户 → 带单账户） out 转出（带单账户 → 现货/资金账户）

coin

string · required

划转币种

amount

string · required

划转数量

inAccountType

string

转入账户类型，支持多选，多个账户类型用英文逗号 , 分隔 funding 现货/资金账户 uta 统一账户 otc OTC账户如不选，默认选择全部账户扣款顺序：资金账户 → OTC账户 → 统一账户经典账户模式仅支持 funding 现货账户转入

带单账户划转 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

transferId

string

划转订单ID

查询带单账户划转记录

GET

https://api.bitget.com

/api/v3/copy/futures/transfer-record

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

查询带单账户的划转历史记录。

查询带单账户划转记录 › Request Parameters

startTime

string

开始时间戳，Unix毫秒时间戳，如 1597026383085

endTime

string

结束时间戳，Unix毫秒时间戳，如 1597026383085

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 transferId 以分页获取更新的数据

查询带单账户划转记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

划转记录列表

获取当前跟随者

GET

https://api.bitget.com

/api/v3/copy/futures/current-follower

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户当前活跃的跟随者列表。

获取当前跟随者 › Request Parameters

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 endId 以分页获取更新的数据

获取当前跟随者 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟随者列表

nextCursor

string

下页游标

获取历史跟随者

GET

https://api.bitget.com

/api/v3/copy/futures/history-follower

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的历史跟随者列表。

获取历史跟随者 › Request Parameters

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 endId 以分页获取更新的数据

获取历史跟随者 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

历史跟随者列表

nextCursor

string

下页游标

获取分润汇总

GET

https://api.bitget.com

/api/v3/copy/futures/profit-summary

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的分润汇总信息。

获取分润汇总 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

totalProfit

string

累计收益，单位为USDT

totalAllocatedProfit

string

累计已分润，单位为USDT

totalPendingProfit

string

累计待分润，单位为USDT

获取分润详情

GET

https://api.bitget.com

/api/v3/copy/futures/profit-details

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的分润明细记录。

获取分润详情 › Request Parameters

startTime

string

开始时间戳，Unix毫秒时间戳，如 1597026383085

endTime

string

结束时间戳，Unix毫秒时间戳，如 1597026383085

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 cursor 以分页获取更新的数据

获取分润详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

分润明细列表

nextCursor

string

游标ID

跟单

合约公域/私域

获取仓位汇总

GET

https://api.bitget.com

/api/v3/copy/futures/position-summary

限频规则: 5次/秒/UID

权限: 统一账户 — 合约带单持仓 — 只读

获取仓位汇总

获取仓位汇总 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

unrealizedPnl

string

未实现盈亏单位：USDT

realizedPnl

string

已实现盈亏单位：USDT

holdSize

string

持仓数量

avgPrice

string

持仓均价

symbol

string

交易对名称

leverage

string

杠杆倍数正整数

marginMode

string

保证金模式： isolated 逐仓 cross 全仓

liqPrice

string

强平价格

margin

string

保证金

holdSide

string

持仓方向： long 多仓 short 空仓

roi

string

回报率

markPrice

string

标记价格

positionValue

string

仓位价值单位：USDT

获取带单币对信息

GET

https://api.bitget.com

/api/v3/copy/futures/trading-pairs

限频规则: 5次/秒/UID

权限: 统一账户 — 合约带单订单 — 只读

获取带单币对信息

获取带单币对信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

leverage

string

杠杆倍数

object[]

保证金明细列表

带单账户最大可转出

GET

https://api.bitget.com

/api/v3/copy/futures/max-transferable

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的最大可转出金额及可用余额。

带单账户最大可转出 › Request Parameters

coin

string · required

币种名称，例如 USDT

带单账户最大可转出 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

maxTransferable

string

最大可转出金额

available

string

可用余额

带单账户划转

POST

https://api.bitget.com

/api/v3/copy/futures/transfer

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单读写权限

将资金转入或转出带单账户。仅支持现货账户（经典）/资金账户（统一）与带单账户之间的划转。

带单账户划转 › Request Parameters

type

string · required

划转类型 in 转入（现货/资金账户 → 带单账户） out 转出（带单账户 → 现货/资金账户）

coin

string · required

划转币种

amount

string · required

划转数量

inAccountType

string

带单账户划转 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

transferId

string

划转订单ID

查询带单账户划转记录

GET

https://api.bitget.com

/api/v3/copy/futures/transfer-record

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

查询带单账户的划转历史记录。

查询带单账户划转记录 › Request Parameters

startTime

string

开始时间戳，Unix毫秒时间戳，如 1597026383085

endTime

string

结束时间戳，Unix毫秒时间戳，如 1597026383085

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 transferId 以分页获取更新的数据

查询带单账户划转记录 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

划转记录列表

获取当前跟随者

GET

https://api.bitget.com

/api/v3/copy/futures/current-follower

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户当前活跃的跟随者列表。

获取当前跟随者 › Request Parameters

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 endId 以分页获取更新的数据

获取当前跟随者 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

跟随者列表

nextCursor

string

下页游标

获取历史跟随者

GET

https://api.bitget.com

/api/v3/copy/futures/history-follower

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的历史跟随者列表。

获取历史跟随者 › Request Parameters

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 endId 以分页获取更新的数据

获取历史跟随者 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

历史跟随者列表

nextCursor

string

下页游标

获取分润汇总

GET

https://api.bitget.com

/api/v3/copy/futures/profit-summary

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的分润汇总信息。

获取分润汇总 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

totalProfit

string

累计收益，单位为USDT

totalAllocatedProfit

string

累计已分润，单位为USDT

totalPendingProfit

string

累计待分润，单位为USDT

获取分润详情

GET

https://api.bitget.com

/api/v3/copy/futures/profit-details

限频规则: 1次/秒/UID

权限: 需要统一账户合约带单订单只读权限

获取带单账户的分润明细记录。

获取分润详情 › Request Parameters

startTime

string

开始时间戳，Unix毫秒时间戳，如 1597026383085

endTime

string

结束时间戳，Unix毫秒时间戳，如 1597026383085

limit

string

查询条数，默认 20，最大 100

cursor

string

游标ID。传入上次调用返回的 cursor 以分页获取更新的数据

获取分润详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

分润明细列表

nextCursor

string

游标ID