获取合约的历史资金费率

/sapi/v1/public/funding_rate_history

请求类型: GET

是否验签: 否

接口权限: 读取

限频: 其他非行情类的公开接口，比如获取指数信息，限价信息，交割结算、平台持仓信息等，所有用户都是每个IP3秒最多240次请求（所有该IP的非行情类的公开接口请求共享3秒240次的额度）

接口描述: 该接口支持全仓模式和逐仓模式

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
page_index	int	false	页码，不填默认第1页
page_size	int	false	不填默认20，不得多于50
contract_code	string	true	合约代码	BTC-USDT等

响应参数

参数	数据类型	是否必填	描述	取值范围
status	string	true	请求处理结果	ok , "error"
ts	long	true	响应生成时间点，单位：毫秒
<data>	object	true
symbol	string	true	品种代码
contract_code	string	true	合约代码	BTC-USDT ...
fee_asset	string	true	资金费币种	USDT...
funding_time	string	true	资金费率时间
funding_rate	string	true	当期资金费率
realized_rate	string	true	实际资金费率（废弃，默认为null）
avg_premium_index	string	true	平均溢价指数
</data>		false
total_page	int	true	总页数
current_page	int	true	当前页
total_size	int	true	总条数
trade_partition	string	true	参数已废弃
</data>		false

请求示例

curl "https://api.sunx.io/sapi/v1/public/funding_rate_history?contract_code=BTC-USDT"

响应示例

{
        "status": "ok",
        "data": {
                "total_page": 1,
                "current_page": 1,
                "total_size": 3,
                "data": [{
                        "avg_premium_index": "-0.000129806166799078",
                        "trade_partition": "USDT",
                        "funding_rate": "0.000100000000000000",
                        "realized_rate": null,
                        "funding_time": "1757980800000",
                        "contract_code": "BTC-USDT",
                        "symbol": "BTC",
                        "fee_asset": "USDT"
                }, {
                        "avg_premium_index": "-0.000033768740337556",
                        "trade_partition": "USDT",
                        "funding_rate": "0.000100000000000000",
                        "realized_rate": null,
                        "funding_time": "1757952000000",
                        "contract_code": "BTC-USDT",
                        "symbol": "BTC",
                        "fee_asset": "USDT"
                }]
        },
        "ts": 1758006694468
}