# 资金费率
### 描述
订阅资金费率频道。订阅成功后会立即推送一次当前资金费率、下次费率、费率上下限与结算周期的全量快照。
此外，本频道还会在以下情况推送：
- 资金费率结算周期从 8h/4h 临时切换为 1h 时，推送含新周期的消息
- 结算周期从 1h 回调至原周期时，推送含回调后周期的消息
- 产生现金派息数据时
- 除上述条件触发推送外，本频道每 60 秒推送一次定时快照
```json title="请求示例"
{
"op": "subscribe",
"args": [
{
"instType": "usdt-futures",
"topic": "funding-rate",
"symbol": "BTCUSDT"
}
]
}
```
### 请求参数
| 参数名 | 类型 | 是否必传 | 描述 |
|---------------|--------------------|------|------------------------------------------------------------------------------------------------------------------------|
| op | String | 是 | 操作
`subscribe` 订阅
`unsubscribe` 取消订阅 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品线类型
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 是 | 频道名
`funding-rate` 资金费率频道 |
| > symbol | String | 是 | 交易对名称
如 `BTCUSDT` |
```json title="返回示例"
{
"event": "subscribe",
"arg": {
"instType": "usdt-futures",
"topic": "funding-rate",
"symbol": "BTCUSDT"
},
"connId": "xxxxxxxxxx"
}
```
### 返回参数
| 参数名 | 类型 | 描述 |
|---------------|--------|------------------------------------------------------------------------------------------------------------------------|
| event | String | 事件 |
| arg | Object | 请求订阅的频道列表 |
| > instType | String | 产品线类型
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`funding-rate` 资金费率频道 |
| > symbol | String | 交易对名称
如 `BTCUSDT` |
| code | String | 错误码 |
| msg | String | 错误信息 |
| connId | String | 连接ID |
```json title="推送数据"
{
"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
}
```
### 推送参数
| 参数名 | 参数类型 | 描述 |
|---------------|--------------------|------------------------------------------------------------------------------------------------------------------------|
| arg | Object | 请求订阅成功的频道列表 |
| > instType | String | 产品线类型
`usdt-futures` USDT合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > topic | String | 频道名
`funding-rate` 资金费率频道 |
| > symbol | String | 交易对名称
如 `BTCUSDT` |
| action | String | 推送数据的方式
`snapshot` 全量
`update` 增量 |
| data | List<Object> | 订阅的数据 |
| > symbol | String | 币对名称，例如 `BTCUSDT` |
| > fundingRate | String | [当前资金费率](https://www.bitget.com/zh-CN/trade-info/funding_rate)。小数形式，`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 股票合约向符合条件的持有人支付的现金分红，具体请参考[这里](https://www.bitget.com/zh-CN/support/articles/12560603884677) |
| > cashDividendNextUpdate | String | 现金派息下次更新时间，只在有现金派息行为的时候有值
Unix毫秒时间戳 |