Get Last Settlement Funding Fee Rate

API Description

This interface allows querying the funding fee rate of the last settlement for a specified perpetual contract. This rate does not reflect the funding rate for the next settlement period, and a considerable amount of time may have passed since last settlement.

Note: Funding Fee Rate data is available via both Resful and Websocket APIs. This page describes the RESTful API. For information on the real-time funding fee rate updates, please click here

Precautions

1. This interface allows querying the funding fee rate of the last settlement for a specified perpetual contract. This rate does not reflect the funding rate for the next settlement period, and a considerable amount of time may have passed since last settlement.

2. The RESTful API provides funding rate information from the last settlement. However, Websocket API and webpage delivers real-time funding rate updates.

3. For contracts not listed in Futures, the following response will be returned:

   {'code': 9001, 'msg': 'Contract not found'}

Authentication

This is a public interface and does not require authentication. For details on using the RESTful API, please refer to Common > Authentication & Code Snippet > Futures > RESTful Public Interface.

Request Method

GET

Endpoint

/v1/perpum/fundingRate

Frequency Limit

The frequency limit for this interface is 8 requests/s per user ID and IP. In addition to this per-interface limit, a global rate limit is also enforced.

For detailed information on Global rate limits and API Rate Limiting Policy, please refer to the "Frequency Limit" section at click here

Request Parameters

Parameter	Mandatory	Type	Description
instrument	true	String	Note: for USDT contracts, pass only the base currency name, for example BTCUSDT can use btc; for USDC contracts, pass the full trading pair, for example BTC_USDC. This parameter is case-sensitive.

Response Parameters

Parameter	Type	Description
data	Object	Response payload
data.value	BigDecimal	Funding fee rate
data.ts	Long	Settlement timestamp (ms)

Request Example

The following Python code shows how to get the current funding fee rate for BTC.

Note: For a complete code example, please refer to Common > Authentication & Code Snippet > Futures > RESTful Public Interface.

api_url = "/v1/perpum/fundingRate"              
params = { "instrument": "btc" } 
         
FuturesRestfulPublic(api_url, params)     # function FuturesRestfulPublic() is defined in section (Common > Authentication & Code Snippet > Futures > RESTful Public Interface)

Note: For a complete Java code example, please refer to Common > Authentication & Code Snippet > Futures > RESTful Public Interface.

Response Example

The following is an example response returned by the above Python request:

{
'code': 0, 
'data': 
  {'value': 2.964e-05, 'ts': 1775443378356}, 
'msg': ''
}