Get historical funding rate

/sapi/v1/public/funding_rate_history

Request type: GET

Signature verification: No

Interface permission: Read

Rate Limit: For public interface used to get information of index, price limit, settlement, delivery, open positions and so on, the rate limit is 240 times every 3 second at most for each IP (this 240 times every 3 second public interface rate limit is shared by all the requests from that IP of non-marketing information, like above).

Interface description: The interface supports cross margin mode and isolated margin mode.

Request Address

Environment	Address
Online	https://api.sunx.io
Online (preferred by aws customers)	https://api.sunx.io

Request Parameter

Parameter	Data Type	Required	Description	Value Range	Default Value
contract_code	string	true	contract code	Case-Insenstive.eg:"BTC-USDT" ...
page_index	int	false	page index. 1 by default
page_size	int	false	page size.20 by default. 50 at most	[1-50]

Response Parameter

Parameter	Data Type	Required	Description	Value Range
status	string	false	response status	"ok" , "error"
ts	long	false	response timestamp.unit:millionSeconds.
<data>		false
symbol	string	false	symbol	eg:"BTC","ETH"...
contract_code	string	false	contract code	eg: "BTC-USDT
fee_asset	string	false	fee asset	eg:"USDT"
funding_time	string	false	funding time
funding_rate	string	false	funding rate
realized_rate	string	false	(Deprecated, default is null)
avg_premium_index	string	false	average premium index
</data>		false
total_page	int	false	total page
current_page	int	false	current page
total_size	int	false	total size
trade_partition	string	true	Deprecated parameter
</data>		false

Request Example

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

Response Example

{
        "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
}