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
Request Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| op | String | Yes | Operation subscribe Subscribe unsubscribe Unsubscribe |
| args | List<Object> | Yes | Subscribed channel |
| > instType | String | Yes | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Yes | Topic funding-rate Funding rate channel |
| > symbol | String | Yes | Trading pair e.g. BTCUSDT |
Code
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| event | String | Event |
| arg | Object | Subscribed channel |
| > instType | String | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Topic funding-rate Funding rate channel |
| > symbol | String | Trading pair e.g. BTCUSDT |
| code | String | Error code |
| msg | String | Error message |
| connId | String | Connection ID |
Code
Push Parameters
| Parameters | Parameter Type | Description |
|---|---|---|
| arg | Object | Subscribed successful channel |
| > instType | String | Product typeusdt-futures USDT futures coin-futures Coin-M futures usdc-futures USDC futures |
| > topic | String | Topic funding-rate Funding rate channel |
| > symbol | String | Trading pair e.g. BTCUSDT |
| action | String | Data push action snapshot Full data update Incremental data |
| data | List<Object> | Subscribed data |
| > 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% |
| > lastFundingRate | String | Last funding rate In decimal form, e.g. 0.000088 represents 0.0088% |
| > nextFundingRate | String | Next funding rate In decimal form, e.g. 0.000088 represents 0.0088% |
| > baseInterestRate | String | Base interest rate In decimal form, e.g. 0.0001 represents 0.01% |
| > impactMarginNotional | String | Impact margin notional Unit: quote coin |
| > 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 |
