交易与风控规则

获取风险准备金(天)

GET

https://api.bitget.com

/api/v3/market/risk-reserve

限频规则: 20次/秒/IP

查询风险准备金(最近30天记录)

获取风险准备金(天) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

marginCoin

string

保证金币种，当 category 为 COIN-FUTURES 币本位合约时必填

获取风险准备金(天) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

totalBalance

string

风险准备金总余额(已废弃)

coin

string

风险准备金结算币种

object[]

风险准备金记录

获取风险准备金(小时)

GET

https://api.bitget.com

/api/v3/market/risk-reserve-hour

限频规则: 20次/秒/IP

查询最近30小时风险准备金数据(小时级别)

获取风险准备金(小时) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

marginCoin

string

保证金币种，当 category 为 COIN-FUTURES 币本位合约时必填

获取风险准备金(小时) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

风险准备金结算币种

object[]

风险准备金记录

获取当前全部风险准备金

GET

https://api.bitget.com

/api/v3/market/risk-reserve-all

限频规则: 3次/秒/IP

获取当前全部风险准备金

独立保险池数据每 1 分钟更新一次，聚合保险池数据每 1 小时更新一次。

获取当前全部风险准备金 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

获取当前全部风险准备金 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

保险池列表

获取杠杆借币信息

GET

https://api.bitget.com

/api/v3/market/margin-loans

限频规则: 20次/秒/IP

获取杠杆借币的利率数据

获取杠杆借币信息 › Request Parameters

coin

string · required

币种名称，例如：BTC

level

string

用户等级
vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7
pro1/pro2/pro3/pro4/pro5/pro6
默认值为vip0

获取杠杆借币信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

dailyInterest

string

日利率

annualInterest

string

年利率

limit

string

限额

masterSubLimit

string

母子账户限额

platformRemaingQuota

string

平台剩余额度

获取借币利率历史

GET

https://api.bitget.com

/api/v3/market/interest-rate-history

查询指定币种、指定 VIP 档位的杠杆借币历史利率序列，用于回测借贷成本、核算历史持仓利息、测算 VIP 升级的利息节省。

数据粒度固定 1 小时，保留最近 1 个月。

限频规则: 10次/秒/UID
需要统一账户管理只读权限

获取借币利率历史 › Request Parameters

coin

string · required

币种，如USDT

仅支持已开放杠杆借贷的币种，未开放币种返回错误

startTime

string

开始时间，Unix毫秒时间戳

仅支持最近 1 个月内的数据

endTime

string

结束时间，Unix毫秒时间戳

与startTime间隔不超过30天

不传时间参数时返回当前时间往前的limit条

level

string

用户等级

vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7

pro1/pro2/pro3/pro4/pro5/pro6

默认值为vip0

limit

string

每页条目数

默认10，最大500

cursor

string

分页游标

取上一页响应的cursor

获取借币利率历史 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

cursor

string

下一页游标

为空表示无更多数据

object[]

利率历史数据集合

获取仓位档位信息

GET

https://api.bitget.com

/api/v3/market/position-tier

限频规则: 20次/秒/IP

获取仓位档位梯度信息

获取仓位档位信息 › Request Parameters

category

string · required

产品类型

MARGIN 杠杆

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT，当业务线为合约时，该字段必填

coin

string

币种名称，例如：BTC，当业务线为杠杆时，该字段必填

获取仓位档位信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

tier

string

档位

leverage

string

有效杠杆倍数

minTierValue

string

当前档位最小价值

仅在合约档位梯度信息返回

maxTierValue

string

当前档位最大价值

仅在合约档位梯度信息返回

mmr

string

维持保证金率

持仓档位对应的数值。当仓位的保证金率小于维持保证金率时，将会触发强制减仓或爆仓

获取合约OI限仓信息

GET

https://api.bitget.com

/api/v3/market/oi-limit

限频规则：10次/秒/IP

获取合约OI限仓信息。

获取合约OI限仓信息 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易币对

获取合约OI限仓信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

产品名称

notionalValue

string

单用户持仓名义价值

totalNotionalValue

string

子母账户持仓名义价值

获取币种折扣率

GET

https://api.bitget.com

/api/v3/market/discount-rate

限频规则: 20次/秒/IP

获取不同档位的币种折扣率信息

获取币种折扣率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称，例如：BTC

object[]

档位列表

公共配置交易统计数据

行情

交易与风控规则

获取风险准备金(天)

GET

https://api.bitget.com

/api/v3/market/risk-reserve

限频规则: 20次/秒/IP

查询风险准备金(最近30天记录)

获取风险准备金(天) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

marginCoin

string

保证金币种，当 category 为 COIN-FUTURES 币本位合约时必填

获取风险准备金(天) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

totalBalance

string

风险准备金总余额(已废弃)

coin

string

风险准备金结算币种

object[]

风险准备金记录

获取风险准备金(小时)

GET

https://api.bitget.com

/api/v3/market/risk-reserve-hour

限频规则: 20次/秒/IP

查询最近30小时风险准备金数据(小时级别)

获取风险准备金(小时) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

marginCoin

string

保证金币种，当 category 为 COIN-FUTURES 币本位合约时必填

获取风险准备金(小时) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

coin

string

风险准备金结算币种

object[]

风险准备金记录

获取当前全部风险准备金

GET

https://api.bitget.com

/api/v3/market/risk-reserve-all

限频规则: 3次/秒/IP

获取当前全部风险准备金

独立保险池数据每 1 分钟更新一次，聚合保险池数据每 1 小时更新一次。

获取当前全部风险准备金 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

获取当前全部风险准备金 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

保险池列表

获取杠杆借币信息

GET

https://api.bitget.com

/api/v3/market/margin-loans

限频规则: 20次/秒/IP

获取杠杆借币的利率数据

获取杠杆借币信息 › Request Parameters

coin

string · required

币种名称，例如：BTC

level

string

用户等级
vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7
pro1/pro2/pro3/pro4/pro5/pro6
默认值为vip0

获取杠杆借币信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

dailyInterest

string

日利率

annualInterest

string

年利率

limit

string

限额

masterSubLimit

string

母子账户限额

platformRemaingQuota

string

平台剩余额度

获取借币利率历史

GET

https://api.bitget.com

/api/v3/market/interest-rate-history

查询指定币种、指定 VIP 档位的杠杆借币历史利率序列，用于回测借贷成本、核算历史持仓利息、测算 VIP 升级的利息节省。

数据粒度固定 1 小时，保留最近 1 个月。

限频规则: 10次/秒/UID
需要统一账户管理只读权限

获取借币利率历史 › Request Parameters

coin

string · required

币种，如USDT

仅支持已开放杠杆借贷的币种，未开放币种返回错误

startTime

string

开始时间，Unix毫秒时间戳

仅支持最近 1 个月内的数据

endTime

string

结束时间，Unix毫秒时间戳

与startTime间隔不超过30天

不传时间参数时返回当前时间往前的limit条

level

string

用户等级

vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7

pro1/pro2/pro3/pro4/pro5/pro6

默认值为vip0

limit

string

每页条目数

默认10，最大500

cursor

string

分页游标

取上一页响应的cursor

获取借币利率历史 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

cursor

string

下一页游标

为空表示无更多数据

object[]

利率历史数据集合

获取仓位档位信息

GET

https://api.bitget.com

/api/v3/market/position-tier

限频规则: 20次/秒/IP

获取仓位档位梯度信息

获取仓位档位信息 › Request Parameters

category

string · required

产品类型

MARGIN 杠杆

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT，当业务线为合约时，该字段必填

coin

string

币种名称，例如：BTC，当业务线为杠杆时，该字段必填

获取仓位档位信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

tier

string

档位

leverage

string

有效杠杆倍数

minTierValue

string

当前档位最小价值

仅在合约档位梯度信息返回

maxTierValue

string

当前档位最大价值

仅在合约档位梯度信息返回

mmr

string

维持保证金率

持仓档位对应的数值。当仓位的保证金率小于维持保证金率时，将会触发强制减仓或爆仓

获取合约OI限仓信息

GET

https://api.bitget.com

/api/v3/market/oi-limit

限频规则：10次/秒/IP

获取合约OI限仓信息。

获取合约OI限仓信息 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易币对

获取合约OI限仓信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

产品名称

notionalValue

string

单用户持仓名义价值

totalNotionalValue

string

子母账户持仓名义价值

获取币种折扣率

GET

https://api.bitget.com

/api/v3/market/discount-rate

限频规则: 20次/秒/IP

获取不同档位的币种折扣率信息

获取币种折扣率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称，例如：BTC

object[]

档位列表

公共配置交易统计数据