交易风控与仓位设置

获取OI限仓

GET

https://api.bitget.com

/api/v3/account/open-interest-limit

限频规则: 5次/秒/UID

OI限仓查询

获取OI限仓 › Request Parameters

symbol

string · required

交易对名称如BTCUSDT

category

string · required

业务线 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

获取OI限仓 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

交易对名称

singleUserLimit

string

单用户限制数量

masterSubLimit

string

子母账户限制数量

marketMakerLimit

string

做市商总额度

获取业务线所有交易对手续费

GET

https://api.bitget.com

/api/v3/account/all-fee-rate

限频规则: 3次/秒/UID

需要统一账户管理只读权限

查询指定业务线下所有交易对的手续费率。

仅传业务线 category，不传交易对 symbol：返回该业务线下所有交易对的手续费
仅传交易对 symbol，不传业务线 category：接口报错
category 和 symbol 均传：返回指定业务线下指定交易对的手续费。若 category 和 symbol 不一致，以 symbol 为准
category 和 symbol 均不传：接口报错

获取业务线所有交易对手续费 › Request Parameters

category

string · required

业务线 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string

交易对名称如BTCUSDT

获取业务线所有交易对手续费 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

makerFeeRate

string

挂单手续费率小数形式，即0.0002代表万分之二

takerFeeRate

string

吃单手续费率小数形式，即0.0002代表万分之二

获取准入用户杠杆交易对

GET

https://api.bitget.com

/api/v3/account/eligible-symbols

限频规则: 10次/秒/UID

需要统一账户管理只读权限

查询准入用户（白名单用户）可交易的全部杠杆交易对。

获取准入用户杠杆交易对 › Request Parameters

symbol

string

交易对名称例如：BTCUSDT

获取准入用户杠杆交易对 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

category

string

产品类型 MARGIN 杠杆交易

baseCoin

string

交易币种例如：BTCUSDT 中的 BTC

quoteCoin

string

计价币种例如：BTCUSDT 中的 USDT

symbolType

string

交易对类别 crypto 加密货币 metal 贵金属 stock 股票 commodity 大宗

buyLimitPriceRatio

string

买价限价比例买入限价与市场价格的比率，决定买单下单时的最高价格

sellLimitPriceRatio

string

卖价限价比例卖出限价与市场价格的比率，决定卖单下单时的最低价格

minOrderQty

string

最小开单数量以基础币种下单时允许的最小数量

maxOrderQty

string

单笔限价单最大下单数量以基础币种下单时允许的最大数量为 0 表示不限制

pricePrecision

string

价格精度价格允许的小数位数

quantityPrecision

string

数量精度数量允许的小数位数

quotePrecision

string

市价下单精度计价币价格允许的小数位数

minOrderAmount

string

最小下单额以计价币种下单时允许的最小数量

maxSymbolOrderNum

string

交易对维度最大委托数量

maxProductOrderNum

string

业务线维度最大委托数量

status

string

交易对状态 listed 上架（未开盘） online 正常交易 limit_open 限制开仓 limit_close 限制平仓 offline 下架/维护 restrictedAPI API限制下单

maintainTime

string

币对维护时间未配置则返回：""

areaSymbol

string

区域限制标识 yes / no

maxPositionNum

string

交易对维度最大持仓数量

isReality

string

Reality 标识 yes Reality 股票代币 no 非 Reality 股票代币

launchTime

string

上线时间 Unix毫秒时间戳，表示交易对的上线时间

GET/api/v3/account/eligible-symbols

curl https://api.bitget.com/api/v3/account/eligible-symbols

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1784618341109,
  "data": [
    {
      "symbol": "RPBRUSDT",
      "category": "MARGIN",
      "baseCoin": "rPBR",
      "quoteCoin": "USDT",
      "symbolType": "stock",
      "buyLimitPriceRatio": "0.1",
      "sellLimitPriceRatio": "0.1",
      "minOrderQty": "0.0001",
      "maxOrderQty": "0",
      "pricePrecision": "2",
      "quantityPrecision": "4",
      "quotePrecision": "6",
      "minOrderAmount": "20",
      "maxSymbolOrderNum": "",
      "maxProductOrderNum": "400",
      "status": "online",
      "maintainTime": "",
      "areaSymbol": "yes",
      "maxPositionNum": "200",
      "isReality": "yes",
      "launchTime": "1781101641926"
    }
  ]
}

json

application/json

获取准入用户杠杆梯度档位

GET

https://api.bitget.com

/api/v3/account/eligible-margin-tier

限频规则: 10次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回杠杆梯度档位信息。

获取准入用户杠杆梯度档位 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户杠杆梯度档位 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

object[]

档位列表

获取准入用户借币数据

GET

https://api.bitget.com

/api/v3/account/eligible-loan-info

限频规则: 10次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回借币数据信息。

获取准入用户借币数据 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户借币数据 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

limit

string

单UID借币上限

masterSubLimit

string

母子账户借币上限

platformRemaingQuota

string

平台剩余额度

获取准入用户币种折扣率梯度

GET

https://api.bitget.com

/api/v3/account/eligible-discount-rate

限频规则: 20次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回币种折扣率梯度信息。

获取准入用户币种折扣率梯度 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户币种折扣率梯度 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

object[]

档位列表

杠杆与借贷管理子账户

获取OI限仓

GET

https://api.bitget.com

/api/v3/account/open-interest-limit

限频规则: 5次/秒/UID

OI限仓查询

获取OI限仓 › Request Parameters

symbol

string · required

交易对名称如BTCUSDT

category

string · required

业务线 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

获取OI限仓 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

交易对名称

singleUserLimit

string

单用户限制数量

masterSubLimit

string

子母账户限制数量

marketMakerLimit

string

做市商总额度

获取业务线所有交易对手续费

GET

https://api.bitget.com

/api/v3/account/all-fee-rate

限频规则: 3次/秒/UID

需要统一账户管理只读权限

查询指定业务线下所有交易对的手续费率。

仅传业务线 category，不传交易对 symbol：返回该业务线下所有交易对的手续费
仅传交易对 symbol，不传业务线 category：接口报错
category 和 symbol 均传：返回指定业务线下指定交易对的手续费。若 category 和 symbol 不一致，以 symbol 为准
category 和 symbol 均不传：接口报错

获取业务线所有交易对手续费 › Request Parameters

category

string · required

业务线 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string

交易对名称如BTCUSDT

获取业务线所有交易对手续费 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

makerFeeRate

string

挂单手续费率小数形式，即0.0002代表万分之二

takerFeeRate

string

吃单手续费率小数形式，即0.0002代表万分之二

获取准入用户杠杆交易对

GET

https://api.bitget.com

/api/v3/account/eligible-symbols

限频规则: 10次/秒/UID

需要统一账户管理只读权限

查询准入用户（白名单用户）可交易的全部杠杆交易对。

获取准入用户杠杆交易对 › Request Parameters

symbol

string

交易对名称例如：BTCUSDT

获取准入用户杠杆交易对 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

交易对名称

category

string

产品类型 MARGIN 杠杆交易

baseCoin

string

交易币种例如：BTCUSDT 中的 BTC

quoteCoin

string

计价币种例如：BTCUSDT 中的 USDT

symbolType

string

交易对类别 crypto 加密货币 metal 贵金属 stock 股票 commodity 大宗

buyLimitPriceRatio

string

买价限价比例买入限价与市场价格的比率，决定买单下单时的最高价格

sellLimitPriceRatio

string

卖价限价比例卖出限价与市场价格的比率，决定卖单下单时的最低价格

minOrderQty

string

最小开单数量以基础币种下单时允许的最小数量

maxOrderQty

string

单笔限价单最大下单数量以基础币种下单时允许的最大数量为 0 表示不限制

pricePrecision

string

价格精度价格允许的小数位数

quantityPrecision

string

数量精度数量允许的小数位数

quotePrecision

string

市价下单精度计价币价格允许的小数位数

minOrderAmount

string

最小下单额以计价币种下单时允许的最小数量

maxSymbolOrderNum

string

交易对维度最大委托数量

maxProductOrderNum

string

业务线维度最大委托数量

status

string

交易对状态 listed 上架（未开盘） online 正常交易 limit_open 限制开仓 limit_close 限制平仓 offline 下架/维护 restrictedAPI API限制下单

maintainTime

string

币对维护时间未配置则返回：""

areaSymbol

string

区域限制标识 yes / no

maxPositionNum

string

交易对维度最大持仓数量

isReality

string

Reality 标识 yes Reality 股票代币 no 非 Reality 股票代币

launchTime

string

上线时间 Unix毫秒时间戳，表示交易对的上线时间

获取准入用户杠杆梯度档位

GET

https://api.bitget.com

/api/v3/account/eligible-margin-tier

限频规则: 10次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回杠杆梯度档位信息。

获取准入用户杠杆梯度档位 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户杠杆梯度档位 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

object[]

档位列表

获取准入用户借币数据

GET

https://api.bitget.com

/api/v3/account/eligible-loan-info

限频规则: 10次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回借币数据信息。

获取准入用户借币数据 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户借币数据 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

limit

string

单UID借币上限

masterSubLimit

string

母子账户借币上限

platformRemaingQuota

string

平台剩余额度

获取准入用户币种折扣率梯度

GET

https://api.bitget.com

/api/v3/account/eligible-discount-rate

限频规则: 20次/秒/UID

需要统一账户管理只读权限

根据用户的准入情况返回币种折扣率梯度信息。

获取准入用户币种折扣率梯度 › Request Parameters

coin

string

币种名称例如：BTC

获取准入用户币种折扣率梯度 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

object[]

档位列表