## 资金费率
----

接口：GET /api/v5/public/funding-rate
描述：获取永续合约的当前资金费率及下次结算时间。资金费率是永续合约的核心机制，反映多空力量对比。
限频：20次/2s

**输入参数**

| 名称 | 类型 | 必选 | 描述 |
| ---- | ---- | ---- | ---- |
| instId | str | Y | 永续合约ID，如 `BTC-USDT-SWAP` |

**输出参数**

| 名称 | 类型 | 描述 |
| ---- | ---- | ---- |
| instId | str | 合约ID |
| instType | str | 产品类型（SWAP） |
| fundingRate | str | 当前资金费率 |
| fundingTime | str | 下次结算时间（毫秒） |
| nextFundingRate | str | 预测下期资金费率（可能为空） |
| nextFundingTime | str | 下下次结算时间（毫秒） |
| settFundingRate | str | 上次已结算资金费率 |
| settState | str | 结算状态：`settled`（已结算）/ `processing`（结算中） |
| prevFundingTime | str | 上次结算时间（毫秒） |
| maxFundingRate | str | 最大资金费率 |
| minFundingRate | str | 最小资金费率 |
| ts | str | 数据时间戳（毫秒） |

**接口示例**

```python
import requests
from datetime import datetime

BASE_URL = "https://www.okx.com/api/v5"

# 获取 BTC 永续资金费率
resp = requests.get(f"{BASE_URL}/public/funding-rate", params={"instId": "BTC-USDT-SWAP"})
data = resp.json()["data"][0]

rate = float(data["fundingRate"])
next_time = datetime.fromtimestamp(int(data["fundingTime"]) / 1000)
print(f"当前资金费率: {rate:.6f} ({rate*100:.4f}%)")
print(f"下次结算时间: {next_time}")
print(f"年化费率: {rate * 3 * 365 * 100:.2f}%")  # 每8小时结算一次
```
