Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
行情
    市场行情数据
      获取交易产品信息get获取RPI交易对列表get获取行情数据get获取深度数据get获取RPI深度数据get获取平台近期成交数据getK线数据get历史K线数据get
    衍生品与资金费率
      获取未平仓合约持仓量(OI)get获取历史爆仓数据get实时资金费率get历史资金费率get获取指数价格成分get
    公共配置
      获取储备金证明get获取做市分数权重get获取机构费率分组get获取现金派息记录get获取拆合股记录get
    交易与风控规则
      获取风险准备金(天)get获取风险准备金(小时)get获取当前全部风险准备金get获取杠杆借币信息get获取仓位档位信息get获取合约OI限仓信息get获取币种折扣率get
    交易统计数据
      获取现货大户净流入信息get获取现货资金流向信息get获取现货24小时资金净流入信息get获取杠杆多空对比信息get获取杠杆借贷存量增速信息get获取杠杆逐仓借贷比信息get获取合约主动买卖量信息get获取合约多空比信息get获取合约大户持仓量多空比信息get获取合约大户账户多空比信息get
行情
行情

交易与风控规则

交易与风控规则


获取风险准备金(天)

GET
https://api.bitget.com
/api/v3/market/risk-reserve

限频规则: 20次/秒/IP

查询风险准备金

获取风险准备金(天) › 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/api/v3/market/risk-reserve
curl 'https://api.bitget.com/api/v3/market/risk-reserve?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "totalBalance": "", "coin": "USDT", "riskReserveRecords": [ { "type": "", "amount": "9.8470265278770000", "balance": "95815.6773460800020000", "ts": "1753718400000" }, { "type": "", "amount": "0.4328615782800000", "balance": "95805.8303195521250000", "ts": "1753632000000" } ] } }
json
application/json

获取风险准备金(小时)

GET
https://api.bitget.com
/api/v3/market/risk-reserve-hour

限频规则: 20次/秒/IP

查询风险准备金(小时)

获取风险准备金(小时) › 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/api/v3/market/risk-reserve-hour
curl 'https://api.bitget.com/api/v3/market/risk-reserve-hour?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "coin": "USDT", "riskReserveRecords": [ { "amount": "9.8470265278770000", "balance": "95815.6773460800020000", "ts": "1753718400000" }, { "amount": "0.4328615782800000", "balance": "95805.8303195521250000", "ts": "1753632000000" } ] } }
json
application/json

获取当前全部风险准备金

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/api/v3/market/risk-reserve-all
curl 'https://api.bitget.com/api/v3/market/risk-reserve-all?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1753793743942, "data": { "list": [ { "symbols": [ "BTCUSDT" ], "coin": "USDT", "balance": "95815.6773460800020000" } ] } }
json
application/json

获取杠杆借币信息

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/api/v3/market/margin-loans
curl 'https://api.bitget.com/api/v3/market/margin-loans?coin=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730912814587, "data": { "dailyInterest": "0.1", "annualInterest": "0.00416667", "limit": "3000", "masterSubLimit": "1000", "platformRemaingQuota": "500000" } }
json
application/json

获取仓位档位信息

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

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

GET/api/v3/market/position-tier
curl 'https://api.bitget.com/api/v3/market/position-tier?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1731146663643, "data": [ { "tier": "1", "minTierValue": "0", "maxTierValue": "100000", "leverage": "125", "mmr": "0.004" } ] }
json
application/json

获取合约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/api/v3/market/oi-limit
curl 'https://api.bitget.com/api/v3/market/oi-limit?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1741665165571, "data": [ { "symbol": "BTCUSDT", "notionalValue": "1000000", "totalNotionalValue": "5000000" }, { "symbol": "ETHUSDT", "notionalValue": "1000000", "totalNotionalValue": "5000000" } ] }
json
application/json

获取币种折扣率

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/api/v3/market/discount-rate
curl https://api.bitget.com/api/v3/market/discount-rate
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730911874605, "data": [ { "coin": "ETH", "list": [ { "tierStartValue": "0", "discountRate": "0.99" }, { "tierStartValue": "40000", "discountRate": "0.98" } ] } ] }
json
application/json

公共配置交易统计数据