衍生品与资金费率

获取未平仓合约持仓量(OI)

GET

https://api.bitget.com

/api/v3/market/open-interest

限频规则: 20次/秒/IP

获取某交易对未平仓合约持仓量(按多空持仓总和计算)。

获取未平仓合约持仓量(OI) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT

获取未平仓合约持仓量(OI) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，例如：BTCUSDT

openInterest

string

未平仓合约持仓量(基础币)

ts

string

记录生成时间

Unix毫秒时间戳

获取合约持仓量历史

GET

https://api.bitget.com

/api/v3/market/open-interest-history

查询合约交易对的历史持仓量数据。

限频规则: 10次/秒/IP

获取合约持仓量历史 › Request Parameters

symbol

string · required

交易对名称

period

string · required

时间粒度

默认5m

支持5m、15m、30m、1h、2h、4h、6h、12h、1d

获取合约持仓量历史 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

持仓量数据集合

symbol

string

币对名称

openInterest

string

未平仓合约持仓量

单位为交易币

oneSideOpenInterest

string

未平仓合约持仓量（单边）

单位为交易币

openInterestValue

string

未平仓合约持仓价值

单位为计价币

openInterestValue = openInterest * markPrice

oneSideOpenInterestValue

string

未平仓合约持仓价值（单边）

单位为计价币

timestamp

string

该周期的结束时间

Unix毫秒时间戳

获取历史爆仓数据

GET

https://api.bitget.com

/api/v3/market/liquidations

限频规则: 5次/秒/IP

查询历史爆仓订单数据，仅返回最近三天的数据，数据会有一些延迟。

获取历史爆仓数据 › Request Parameters

category

string · required

产品类型

USDT-FUTURES USDT合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，如BTCUSDT

limit

string

每页条目数

默认值为100，最大值为100

cursor

string

游标ID

传入上次查询响应中的cursor用于分页查询

获取历史爆仓数据 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，如BTCUSDT

side

string

仓位方向

buy 多仓强平

sell 空仓强平

price

string

强平价格

amount

string

强平数量(基础币)

ts

string

强平时间

Unix毫秒时间戳

cursor

string

游标ID

实时资金费率

GET

https://api.bitget.com

/api/v3/market/current-fund-rate

限频规则: 20次/秒/IP

获取合约实时资金费率接口。

实时资金费率 › Request Parameters

category

string

业务线

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT

category和symbol不可同时为空

实时资金费率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

币对名称，例如BTCUSDT

fundingRate

string

当前资金费率。小数形式，0.000088即代表0.0088%

fundingRateInterval

string

资金费率结算周期,单位为小时

数字1代表1小时，2代表2小时，以此类推

nextUpdate

string

资金费率下次更新时间

Unix毫秒时间戳

minFundingRate

string

资金费率下限

以小数形式返回，例如：0.025为2.5%

maxFundingRate

string

资金费率上限

以小数形式返回，例如：0.025为2.5%

lastFundingRate

string

上次资金费率
小数形式返回，如 0.000088 表示 0.0088

nextFundingRate

string

下次资金费率
小数形式返回，如 0.000088 表示 0.0088

baseInterestRate

string

基础利率
小数形式返回，如 0.0001 表示 0.01%

impactMarginNotional

string

冲击保证金影响额
单位：计价币

cashDividend

string

每股现金派息，单位为USDT，只在有现金派息行为的时候有值

RWA股票合约向符合条件的持有人支付的现金分红，具体请参考这里

cashDividendNextUpdate

string

现金派息下次更新时间，只在有现金派息行为的时候有值

Unix毫秒时间戳

历史资金费率

GET

https://api.bitget.com

/api/v3/market/history-fund-rate

限频规则: 20次/秒/IP

获取合约的历史资金费率(最近90天)。资金结算时间会因不同交易对而不同。

历史资金费率 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

cursor

string

分页游标，用于翻页

最大支持100，默认为1

limit

string

每页条目数

最大支持100，默认20

历史资金费率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，例如BTCUSDT

fundingRate

string

资金费率

小数形式，例如：0.000074代表0.0074%

fundingRateTimestamp

string

结算时间

Unix毫秒时间戳

获取指数价格成分

GET

https://api.bitget.com

/api/v3/market/index-components

限频规则：10次/秒/IP

获取指数价格成分。

获取指数价格成分 › Request Parameters

symbol

string · required

交易币对

获取指数价格成分 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

交易对名称

object[]

exchange

string

交易所

spotPair

string

现货交易对名称

equivalentPrice

string

等值价格

weight

string

计算权重

小数形式，如0.5代表50%

GET/api/v3/market/index-components

curl 'https://api.bitget.com/api/v3/market/index-components?symbol=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1767159256214,
  "data": {
    "symbol": "BTCUSDT",
    "componentList": [
      {
        "exchange": "BITGET_FUTURE",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88432.1",
        "weight": "0.4696"
      },
      {
        "exchange": "GATEIO",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88467",
        "weight": "0.164"
      },
      {
        "exchange": "BINANCE",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88456.65",
        "weight": "0.1434"
      },
      {
        "exchange": "MEXC",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88457.1",
        "weight": "0.0992"
      },
      {
        "exchange": "BITGET",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88469.77",
        "weight": "0.0768"
      },
      {
        "exchange": "OKX",
        "spotPair": "BTC/USDT",
        "equivalentPrice": "88463",
        "weight": "0.0468"
      }
    ]
  }
}

json

application/json

市场行情数据公共配置

获取未平仓合约持仓量(OI)

GET

https://api.bitget.com

/api/v3/market/open-interest

限频规则: 20次/秒/IP

获取某交易对未平仓合约持仓量(按多空持仓总和计算)。

获取未平仓合约持仓量(OI) › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT

获取未平仓合约持仓量(OI) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，例如：BTCUSDT

openInterest

string

未平仓合约持仓量(基础币)

ts

string

记录生成时间

Unix毫秒时间戳

获取合约持仓量历史

GET

https://api.bitget.com

/api/v3/market/open-interest-history

查询合约交易对的历史持仓量数据。

限频规则: 10次/秒/IP

获取合约持仓量历史 › Request Parameters

symbol

string · required

交易对名称

period

string · required

时间粒度

默认5m

支持5m、15m、30m、1h、2h、4h、6h、12h、1d

获取合约持仓量历史 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

持仓量数据集合

symbol

string

币对名称

openInterest

string

未平仓合约持仓量

单位为交易币

oneSideOpenInterest

string

未平仓合约持仓量（单边）

单位为交易币

openInterestValue

string

未平仓合约持仓价值

单位为计价币

openInterestValue = openInterest * markPrice

oneSideOpenInterestValue

string

未平仓合约持仓价值（单边）

单位为计价币

timestamp

string

该周期的结束时间

Unix毫秒时间戳

获取历史爆仓数据

GET

https://api.bitget.com

/api/v3/market/liquidations

限频规则: 5次/秒/IP

查询历史爆仓订单数据，仅返回最近三天的数据，数据会有一些延迟。

获取历史爆仓数据 › Request Parameters

category

string · required

产品类型

USDT-FUTURES USDT合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，如BTCUSDT

limit

string

每页条目数

默认值为100，最大值为100

cursor

string

游标ID

传入上次查询响应中的cursor用于分页查询

获取历史爆仓数据 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，如BTCUSDT

side

string

仓位方向

buy 多仓强平

sell 空仓强平

price

string

强平价格

amount

string

强平数量(基础币)

ts

string

强平时间

Unix毫秒时间戳

cursor

string

游标ID

实时资金费率

GET

https://api.bitget.com

/api/v3/market/current-fund-rate

限频规则: 20次/秒/IP

获取合约实时资金费率接口。

实时资金费率 › Request Parameters

category

string

业务线

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string

交易对名称，例如：BTCUSDT

category和symbol不可同时为空

实时资金费率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

币对名称，例如BTCUSDT

fundingRate

string

当前资金费率。小数形式，0.000088即代表0.0088%

fundingRateInterval

string

资金费率结算周期,单位为小时

数字1代表1小时，2代表2小时，以此类推

nextUpdate

string

资金费率下次更新时间

Unix毫秒时间戳

minFundingRate

string

资金费率下限

以小数形式返回，例如：0.025为2.5%

maxFundingRate

string

资金费率上限

以小数形式返回，例如：0.025为2.5%

lastFundingRate

string

上次资金费率
小数形式返回，如 0.000088 表示 0.0088

nextFundingRate

string

下次资金费率
小数形式返回，如 0.000088 表示 0.0088

baseInterestRate

string

基础利率
小数形式返回，如 0.0001 表示 0.01%

impactMarginNotional

string

冲击保证金影响额
单位：计价币

cashDividend

string

每股现金派息，单位为USDT，只在有现金派息行为的时候有值

RWA股票合约向符合条件的持有人支付的现金分红，具体请参考这里

cashDividendNextUpdate

string

现金派息下次更新时间，只在有现金派息行为的时候有值

Unix毫秒时间戳

历史资金费率

GET

https://api.bitget.com

/api/v3/market/history-fund-rate

限频规则: 20次/秒/IP

获取合约的历史资金费率(最近90天)。资金结算时间会因不同交易对而不同。

历史资金费率 › Request Parameters

category

string · required

产品类型

USDT-FUTURES U本位合约

COIN-FUTURES 币本位合约

USDC-FUTURES USDC合约

symbol

string · required

交易对名称，例如：BTCUSDT

cursor

string

分页游标，用于翻页

最大支持100，默认为1

limit

string

每页条目数

最大支持100，默认20

历史资金费率 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

symbol

string

交易对名称，例如BTCUSDT

fundingRate

string

资金费率

小数形式，例如：0.000074代表0.0074%

fundingRateTimestamp

string

结算时间

Unix毫秒时间戳

获取指数价格成分

GET

https://api.bitget.com

/api/v3/market/index-components

限频规则：10次/秒/IP

获取指数价格成分。

获取指数价格成分 › Request Parameters

symbol

string · required

交易币对

获取指数价格成分 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

交易对名称

object[]

exchange

string

交易所

spotPair

string

现货交易对名称

equivalentPrice

string

等值价格

weight

string

计算权重

小数形式，如0.5代表50%