Historical Funding Rates – Kraken

This endpoint returns the historical funding rates for each funding period since first trading time of a perpetual futures contract.

Authentication is not required.

Endpoint	Request Type	Permissible API Keys
/api/v4/historicalfundingrates	GET	N/A

Argument	Type	Required	Description
symbol	string	Yes	The symbol of the Futures, see Ticker Symbols

Sample Call

https://futures.kraken.com/derivatives/api/v4/historicalfundingrates?symbol=PI_XBTUSD

https://futures.kraken.com/derivatives/api/v4/historicalfundingrates?symbol=PI_ETHUSD

Sample Return if Successful

{
"rates": [
{
"timestamp": "2018-08-31T16:00:00.000Z",
"fundingRate": 1.0327058177e-8,
"relativeFundingRate": 0.00007182407
},

{
"timestamp": "2018-08-31T20:00:00.000Z",
"fundingRate": -1.2047162502e-8,
"relativeFundingRate": -0.000084873103125
},

{
"timestamp": "2018-09-01T00:00:00.000Z",
"fundingRate": -9.645113378e-9,
"relativeFundingRate": -0.0000676651
},

{
"timestamp": "2018-09-01T04:00:00.000Z",
"fundingRate": -8.028122964e-9,
"relativeFundingRate": -0.0000566897875
},
...
]
}

Field	Type	Description
rates	List of structures	A list containing structures with historical funding rate information. The list is sorted ascending by timestamp
timestamp	ISO8601 datetime	The date and time UTC of the period to which the funding rate applies
fundingRate	Float	The absolute funding rate for the listed time period
relativeFundingRate	Float	The relative funding rate for the listed time period

Sample Return if Unsuccessful

{
"status": "BAD_REQUEST",
"result": "error",
"errors": [
{
"code": 11,
"message": "Argument invalid: symbol"
}
].,
"serverTime": "2021-05-31T18:30:38.090Z"
}

Field	Type	Description
status	String	Always "BAD_REQUEST"
result	String	Always error
serverTime	ISO8601 datetime	The server date and time
code	Integer	Always 11
message	String	The reason the API call failed, always: Argument invalid: symbol

Related articles