资金费率 (Funding Rates)
查询市场资金费率及历史记录。资金费率是永续合约特有的机制，用于使合约价格锚定现货价格。
获取所有市场费率
接口信息
- Method:
GET - Path:
/api/v1/funding-rates - Authentication: 不需要
响应示例
{
"rates": [
{
"symbol": "BTCUSDT",
"funding_rate": "0.0001",
"next_funding_rate": "0.00012",
"next_funding_time": 1704096000000,
"mark_price": "65000.00",
"index_price": "64995.00",
"updated_at": "2024-01-01T00:00:00Z"
},
{
"symbol": "ETHUSDT",
"funding_rate": "0.00015",
"next_funding_rate": "0.00018",
"next_funding_time": 1704096000000,
"mark_price": "3500.00",
"index_price": "3498.00",
"updated_at": "2024-01-01T00:00:00Z"
}
]
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| rates | array | 资金费率列表 |
FundingRateInfo 对象字段
| 字段 | 类型 | 描述 |
|---|---|---|
| symbol | string | 交易对 |
| funding_rate | string | 当前资金费率 |
| next_funding_rate | string | 预测下次资金费率 |
| next_funding_time | number | 下次结算时间（Unix 时间戳，毫秒） |
| mark_price | string | 标记价格 |
| index_price | string | 指数价格 |
| updated_at | string | 更新时间 |
获取特定市场费率
接口信息
- Method:
GET - Path:
/api/v1/funding-rates/:symbol - Authentication: 不需要
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
响应示例
{
"symbol": "BTCUSDT",
"funding_rate": "0.0001",
"next_funding_rate": "0.00012",
"next_funding_time": 1704096000000,
"mark_price": "65000.00",
"index_price": "64995.00",
"updated_at": "2024-01-01T00:00:00Z"
}
获取费率历史
接口信息
- Method:
GET - Path:
/api/v1/funding-rates/:symbol/history - Authentication: 不需要
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
查询参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| limit | number | 否 | 返回数量（默认 100，最大 1000） |
响应示例
{
"rates": [
{
"symbol": "BTCUSDT",
"funding_rate": "0.0001",
"next_funding_rate": "0.00012",
"next_funding_time": 1704096000000,
"mark_price": "65000.00",
"index_price": "64995.00",
"updated_at": "2024-01-01T00:00:00Z"
},
{
"symbol": "BTCUSDT",
"funding_rate": "0.00008",
"next_funding_rate": "0.0001",
"next_funding_time": 1704067200000,
"mark_price": "64800.00",
"index_price": "64795.00",
"updated_at": "2023-12-31T16:00:00Z"
}
]
}
获取用户结算记录
接口信息
- Method:
GET - Path:
/api/v1/funding/settlements - Authentication: 需要身份验证
查询参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| limit | number | 否 | 返回数量（默认 100） |
响应示例
{
"settlements": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"symbol": "BTCUSDT",
"position_id": "550e8400-e29b-41d4-a716-446655440001",
"funding_rate": "0.0001",
"position_size": "6500.00",
"payment": "-0.65",
"settled_at": "2024-01-01T00:00:00Z"
},
{
"id": "550e8400-e29b-41d4-a716-446655440002",
"symbol": "ETHUSDT",
"position_id": "550e8400-e29b-41d4-a716-446655440003",
"funding_rate": "0.00015",
"position_size": "3500.00",
"payment": "-0.525",
"settled_at": "2024-01-01T00:00:00Z"
}
]
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| settlements | array | 结算记录列表 |
FundingSettlement 对象字段
| 字段 | 类型 | 描述 |
|---|---|---|
| id | string | 结算记录 ID |
| symbol | string | 交易对 |
| position_id | string | 仓位 ID |
| funding_rate | string | 资金费率 |
| position_size | string | 仓位大小（USD） |
| payment | string | 支付金额（负数表示支付，正数表示收取） |
| settled_at | string | 结算时间 |
资金费率说明
计算公式
资金费用 = 仓位价值 × 资金费率
- 多头仓位: 当资金费率为正时，多头支付给空头
- 空头仓位: 当资金费率为负时，空头支付给多头
结算周期
- 资金费率每 8 小时 结算一次
- 结算时间：00:00 UTC、08:00 UTC、16:00 UTC
- 只有在结算时刻持有仓位的用户才需要支付或收取资金费用
费率范围
- 通常在 -0.05% 到 +0.05% 之间
- 极端市场情况下可能超出此范围
- 费率为正表示多头支付空头
- 费率为负表示空头支付多头
说明
- 资金费率数据来源于 OKX 交易所
- 所有金额和费率均为字符串格式以保证精度
- 历史记录按时间倒序排列（最新的在前）
- 用户结算记录仅显示实际持仓期间的结算