获取仓位资金费率历史记录

信息

• 该接口需要签名，具体签名规则请参阅认证
• 该接口会触发限频，具体规则请参阅限频

提示

资金费用机制是为了使合约市场价格锚定现货价格，合约市场价格与现货市场价一旦存在价差，持仓者需要定期向多头或空头交易者支付一定的资金费用

HTTP 请求

GET /futures/position-funding-history

请求参数

参数名	是否必须	类型	说明
market	false	string	市场名称
market_type	true	string	市场类型。 注意：在现货相关功能中，只可使用 SPOT 或 MARGIN 在合约相关功能中，只可使用FUTURES
start_time	false	int	查询开始时间。 默认不根据时间过滤数据
end_time	false	int	查询结束时间。 默认不根据时间过滤数据
page	false	int	分页页数。默认页数为 1
limit	false	int	分页数量。默认数量为 10

请求响应

参数名	类型	说明
market	string	市场名称
market_type	string	市场类型
ccy	string	结算币种名称
position_id	int	仓位 ID
side	string	仓位方向
margin_mode	string	仓位类型
open_interest	string	持仓数量
settle_price	string	结算价格
funding_rate	string	资金费率
funding_value	string	资金费用
created_at	int	数据创建时间

---

请求示例

GET /futures/position-funding-history?market=CETUSDT&market_type=FUTURES&start_time=1636451914231&page=1&limit=100

响应示例

{
    "code": 0,
    "message": "OK",
    "data": [
        {
        "market": " CETUSDT",
        "market_type": "FUTURES",
        "ccy": "USDT",
        "position_id": 927266133,
        "side": "long",
        "margin_mode": "cross",
        "open_interest": "129384.12"
        "settle_price": "0.0642",
        "funding_rate": "0.0003",
        "funding_value": "2.49193815",
        "created_at": 1691482451000
        }
    ],
    "pagination": {
        "has_next": false
    }
}