Skip to main content

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 Introduction > 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​

ParameterMandatoryTypeDescription
instrumenttrueStringNote: 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​

ParameterTypeDescription
dataObjectResponse payload
data.valueBigDecimalFunding fee rate
data.tsLongSettlement 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 Introduction > 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 (Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface)

Note: For a complete Java code example, please refer to Introduction > 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': ''
}