Skip to main content
GET
/
api
/
v1
/
funding
/
history
Funding History
curl --request GET \
  --url https://api.example.com/api/v1/funding/history
Returns historical funding rate data for a given symbol. KROVN stores up to 2 years of funding history, enabling long-term analysis of leverage sentiment.

​
Parameters

ParameterTypeDefaultDescription
symbolstringBTCUSDTTrading pair (e.g. ETHUSDT, SOLUSDT)
limitnumber100Number of settlements to return (max 1000)

​
Example Request

curl -X GET "https://krovn.io/api/v1/funding/history?symbol=BTCUSDT&limit=3" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "symbol": "BTCUSDT",
  "data": [
    {
      "timestamp": "2026-03-20T16:00:00.000Z",
      "rate": "0.00028500",
      "annualized": "31.21"
    },
    {
      "timestamp": "2026-03-21T00:00:00.000Z",
      "rate": "0.00025100",
      "annualized": "27.48"
    },
    {
      "timestamp": "2026-03-21T08:00:00.000Z",
      "rate": "0.00031200",
      "annualized": "34.16"
    }
  ]
}
Data is returned in ascending chronological order (oldest first). Settlements occur every 8 hours at 00:00, 08:00, and 16:00 UTC.