Derivatives & Funding Rate

Get Open Interest (OI)

GET

https://api.bitget.com

/api/v3/market/open-interest

Rate limit: 20/sec/IP

Query the open interest of a trading pair (calculated as the sum of long and short positions).

Get Open Interest (OI) › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Open Interest (OI) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Liquidations History

GET

https://api.bitget.com

/api/v3/market/liquidations

Rate limit: 5/sec/IP

Query historical liquidation order data. Only the data from the last 3 days is available. There may be some delay in the data.

Get Liquidations History › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

limit

string

Items per page

Default: 100. Maximum: 100

cursor

string

Cursor ID

Pass the cursor from the last query response for paginated queries

Get Liquidations History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

cursor

string

Cursor ID

Get Current Funding Rate

GET

https://api.bitget.com

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

Rate limit: 20/sec/IP

Get current funding rate.

Get Current Funding Rate › Request Parameters

category

string

Product type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Trading pair name, e.g. BTCUSDT

category and symbol cannot both be empty

Get Current Funding Rate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

Trading pair name, e.g. BTCUSDT

fundingRate

string

Current funding rate. In decimal form, e.g. 0.000088 represents 0.0088%

fundingRateInterval

string

Funding rate settlement period, unit: hour

1 represents 1 hour, 2 represents 2 hours, and so on

nextUpdate

string

Next update time of the funding rate

Unix millisecond timestamp

minFundingRate

string

Lower limit of funding rate

Returned in decimal form, e.g. 0.025 represents 2.5%

maxFundingRate

string

Upper limit of funding rate

Returned in decimal form, e.g. 0.025 represents 2.5%

cashDividend

string

Per-share cash dividend, unit: USDT. Only has a value when there is a cash dividend event

Cash dividend paid by RWA stock contracts to eligible holders. For details, refer to this article

cashDividendNextUpdate

string

Next update time of the cash dividend. Only has a value when there is a cash dividend event

Unix millisecond timestamp

Get Funding Rate History

GET

https://api.bitget.com

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

Rate limit: 20/sec/IP

Get historical funding rate records for the contract (last 90 days). The funding settlement time varies by trading pair.

Get Funding Rate History › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

cursor

string

Page cursor, used for pagination

Maximum: 100. Default: 1

limit

string

Items per page

Maximum: 100. Default: 20

Get Funding Rate History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Get Index Price Components

GET

https://api.bitget.com

/api/v3/market/index-components

Rate limit: 10/sec/IP

Get index price components.

Get Index Price Components › Request Parameters

symbol

string · required

Trading pair, e.g. BTCUSDT

Get Index Price Components › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

Trading pair

object[]

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

Market Data Public Config

Get Open Interest (OI)

GET

https://api.bitget.com

/api/v3/market/open-interest

Rate limit: 20/sec/IP

Query the open interest of a trading pair (calculated as the sum of long and short positions).

Get Open Interest (OI) › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Open Interest (OI) › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Liquidations History

GET

https://api.bitget.com

/api/v3/market/liquidations

Rate limit: 5/sec/IP

Query historical liquidation order data. Only the data from the last 3 days is available. There may be some delay in the data.

Get Liquidations History › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

limit

string

Items per page

Default: 100. Maximum: 100

cursor

string

Cursor ID

Pass the cursor from the last query response for paginated queries

Get Liquidations History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

cursor

string

Cursor ID

Get Current Funding Rate

GET

https://api.bitget.com

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

Rate limit: 20/sec/IP

Get current funding rate.

Get Current Funding Rate › Request Parameters

category

string

Product type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Trading pair name, e.g. BTCUSDT

category and symbol cannot both be empty

Get Current Funding Rate › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

Trading pair name, e.g. BTCUSDT

fundingRate

string

Current funding rate. In decimal form, e.g. 0.000088 represents 0.0088%

fundingRateInterval

string

Funding rate settlement period, unit: hour

1 represents 1 hour, 2 represents 2 hours, and so on

nextUpdate

string

Next update time of the funding rate

Unix millisecond timestamp

minFundingRate

string

Lower limit of funding rate

Returned in decimal form, e.g. 0.025 represents 2.5%

maxFundingRate

string

Upper limit of funding rate

Returned in decimal form, e.g. 0.025 represents 2.5%

cashDividend

string

Per-share cash dividend, unit: USDT. Only has a value when there is a cash dividend event

Cash dividend paid by RWA stock contracts to eligible holders. For details, refer to this article

cashDividendNextUpdate

string

Next update time of the cash dividend. Only has a value when there is a cash dividend event

Unix millisecond timestamp

Get Funding Rate History

GET

https://api.bitget.com

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

Rate limit: 20/sec/IP

Get historical funding rate records for the contract (last 90 days). The funding settlement time varies by trading pair.

Get Funding Rate History › Request Parameters

category

string · required

Product Type

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

cursor

string

Page cursor, used for pagination

Maximum: 100. Default: 1

limit

string

Items per page

Maximum: 100. Default: 20

Get Funding Rate History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Get Index Price Components

GET

https://api.bitget.com

/api/v3/market/index-components

Rate limit: 10/sec/IP

Get index price components.

Get Index Price Components › Request Parameters

symbol

string · required

Trading pair, e.g. BTCUSDT

Get Index Price Components › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

Trading pair

object[]