Get Funding Rate History

API Description

Retrieves historical funding rate data for perpetual contracts. This endpoint provides funding rate information which is crucial for understanding the cost of holding positions in perpetual futures.

HTTP Request

GET /v5/market/funding/history

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Symbol name (e.g., BTCUSDT)
startTime	string	No	Start time (ms)
endTime	string	No	End time (ms)
limit	number	No	Number of records (max 200)

Response Parameters

Parameter	Type	Description
type	string	Funding type (PAY_FUNDING, etc.)
fundingRate	string	Funding rate applied
fundingAmount	string	Funding amount paid or received
Time	string	Funding time timestamp
blockInfo	object	Block information
-> height	number	Block height
-> timestamp	number	Block timestamp

Request Example

cURL

curl -X GET \
  'https://api.synfutures.com/v5/market/funding/history?category=linear&symbol=BTCUSDT&limit=50' \
  -H 'Content-Type: application/json'

JavaScript (Fetch)

const response = await fetch(
    "https://api.synfutures.com/v5/market/funding/history?category=linear&symbol=BTCUSDT&limit=50",
    {
        method: "GET",
        headers: {
            "Content-Type": "application/json",
        },
    }
);

const data = await response.json();
console.log(data);

Python (requests)

import requests

url = "https://api.synfutures.com/v5/market/funding/history"
params = {
    'category': 'linear',
    'symbol': 'BTCUSDT',
    'limit': 50
}
headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
print(result)

Response Example

Success Response

{
    "data": [
        {
            "instrumentAddrress": "0x1a8a5872b5b82686e1271a363556335a5f540dae",
            "symbol": "BTC-USDM-EMG",
            "expiry": 4294967295,
            "type": "PAY_FUNDING",
            "fundingRate": "0.0001",
            "fundingAmount": "100.00",
            "Time": "1684738540559",
            "blockInfo": {
                "height": 162708,
                "timestamp": 1761278396
            }
        }
    ],
    "msg": "",
    "code": 200,
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}