Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Websocket
Public
    Tickers ChannelCandlestick ChannelDepth ChannelPublic Trades ChannelRPI Depth ChannelLiquidation ChannelInstruments ChannelOpen Interest Limit ChannelPosition Tier ChannelFunding Rate ChannelMargin Loan ChannelMargin Coins Channel
Private
Reality
SBE
Public

Funding Rate Channel

Description

Subscribe to the funding rate channel. A full snapshot (current funding rate, next funding rate, upper/lower rate limits, and settlement period) is pushed immediately after a successful subscription.

In addition, this channel pushes:

  • When the funding rate settlement period temporarily switches from 8h/4h to 1h, a message containing the new period
  • When the settlement period reverts from 1h back to the original period, a message containing the reverted period
  • When a cash dividend event occurs
  • A heartbeat push every 60 seconds regardless of whether the above conditions are triggered
Code
{ "op": "subscribe", "args": [ { "instType": "usdt-futures", "topic": "funding-rate", "symbol": "BTCUSDT" } ] }

Request Parameters

ParametersTypeRequiredDescription
opStringYesOperation
subscribe Subscribe
unsubscribe Unsubscribe
argsList<Object>YesSubscribed channel
> instTypeStringYesProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringYesTopic
funding-rate Funding rate channel
> symbolStringYesTrading pair
e.g. BTCUSDT
Code
{ "event": "subscribe", "arg": { "instType": "usdt-futures", "topic": "funding-rate", "symbol": "BTCUSDT" }, "connId": "xxxxxxxxxx" }

Response Parameters

ParametersTypeDescription
eventStringEvent
argObjectSubscribed channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
funding-rate Funding rate channel
> symbolStringTrading pair
e.g. BTCUSDT
codeStringError code
msgStringError message
connIdStringConnection ID
Code
{ "data": [ { "symbol": "BTCUSDT", "fundingRate": "0.000071", "fundingRateInterval": "8", "nextUpdate": "1743062400000", "minFundingRate": "-0.003", "maxFundingRate": "0.003", "lastFundingRate": "0.000071", "nextFundingRate": "0.000088", "baseInterestRate": "0.0001", "impactMarginNotional": "20000", "cashDividend": null, "cashDividendNextUpdate": null } ], "arg": { "instType": "usdt-futures", "topic": "funding-rate", "symbol": "BTCUSDT" }, "action": "snapshot", "ts": 1736371332162 }

Push Parameters

ParametersParameter TypeDescription
argObjectSubscribed successful channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
funding-rate Funding rate channel
> symbolStringTrading pair
e.g. BTCUSDT
actionStringData push action
snapshot Full data
update Incremental data
dataList<Object>Subscribed data
> symbolStringTrading pair name, e.g. BTCUSDT
> fundingRateStringCurrent funding rate. In decimal form, e.g. 0.000088 represents 0.0088%
> fundingRateIntervalStringFunding rate settlement period, unit: hour
1 represents 1 hour, 2 represents 2 hours, and so on
> nextUpdateStringNext update time of the funding rate
Unix millisecond timestamp
> minFundingRateStringLower limit of funding rate
Returned in decimal form, e.g. 0.025 represents 2.5%
> maxFundingRateStringUpper limit of funding rate
Returned in decimal form, e.g. 0.025 represents 2.5%
> lastFundingRateStringLast funding rate
In decimal form, e.g. 0.000088 represents 0.0088%
> nextFundingRateStringNext funding rate
In decimal form, e.g. 0.000088 represents 0.0088%
> baseInterestRateStringBase interest rate
In decimal form, e.g. 0.0001 represents 0.01%
> impactMarginNotionalStringImpact margin notional
Unit: quote coin
> cashDividendStringPer-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
> cashDividendNextUpdateStringNext update time of the cash dividend. Only has a value when there is a cash dividend event
Unix millisecond timestamp
Position Tier ChannelMargin Loan Channel
JSON
JSON
JSON