Get Position Funding Rate History

Info

• This endpoint requires signature. For specific signature rules, please refer to Authentication
• This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

Reminder

Funding Rate mechanism is to anchor the futures market price to the spot price. Once there is a price difference between the futures market and the spot market, the position holders will need to pay a certain funding fee to long or short traders regularly

HTTP request

GET /futures/position-funding-history

Request parameters

Parameter Name	Required	Type	Notes
market	false	string	Market name
market_type	true	string	Market type. Note: In spot related functions, only SPOT or MARGIN can be used. In futures related functions, only FUTURES can be used.
start_time	false	int	Query start time. Data will not be filtered based on time by default
end_time	false	int	Query end time. Data will not be filtered based on time by default
page	false	int	Number of pagination. Default is 1
limit	false	int	Number in each page. Default is 10

Return parameters

Parameter Name	Type	Notes
market	string	Market name
market_type	string	Market Type
ccy	string	Settlement currency name
position_id	int	Position ID
side	string	Position side
margin_mode	string	Position type
open_interest	string	Position
settle_price	string	Settlement price
funding_rate	string	Funding rate
funding_value	string	Funding rate
created_at	int	Data creation time

---

Request example

GET /futures/position-funding-history?market=CETUSDT&market_type=FUTURES&start_time=1636451914231&page=1&limit=100

Response example

{
    "code": 0,
    "message": "OK",
    "data": [
        {
        "market": " CETUSDT",
        "market_type": "FUTURES",
        "ccy": "USDT",
        "position_id": 927266133,
        "side": "long",
        "margin_mode": "cross",
        "open_interest": "129384.12"
        "settle_price": "0.0642",
        "funding_rate": "0.0003",
        "funding_value": "2.49193815",
        "created_at": 1691482451000
        }
    ],
    "pagination": {
        "has_next": false
    }
}