Skip to main content

Funding Rate History

Query historical funding rate settlement records using cursor pagination.

API Information

  • Method: GET
  • Path: /fapi/v1/fundingRate

Request Parameters

ParameterLocationTypeRequiredDescription
symbolquerystringNoTrading pair, e.g. BTC_USDT
startTimequeryintegerNoStart time (milliseconds timestamp)
endTimequeryintegerNoEnd time (milliseconds timestamp)
limitqueryintegerNoNumber of records returned, default 100, max 1000
cursorquerystringNoCursor

Request Example

GET /fapi/v1/fundingRate?symbol=BTC_USDT&limit=100

Response Fields

FieldTypeDescription
codeintegerStatus code
messagestringResponse message
data.limitintegerPage size
data.next_cursorstringNext page cursor
data.listarrayFunding rate record list
data.list[].symbolstringTrading pair
data.list[].fundingRatestringFunding rate (6 decimals, positive means longs pay shorts)
data.list[].markPricestringMark price
data.list[].fundingTimeintegerSettlement time (milliseconds timestamp)

Response Example

{
"code": 0,
"message": "success",
"data": {
"limit": 100,
"next_cursor": "1712534400000",
"list": [
{
"symbol": "BTC_USDT",
"fundingRate": "0.00010000",
"markPrice": "68500.00",
"fundingTime": 1712534400000
}
]
}
}