Funding is what keeps a perpetual's price close to the asset's: when longs pay shorts, the perp trades rich, and the other way round. For a carry trade, a basis strategy or a backtest, the history of those payments matters as much as the price. This guide explains how Hyperliquid computes funding, what the official API returns, and how to get every print since May 2023.
How Hyperliquid funding works
From Hyperliquid's funding page:
- Every hour. "The funding rate on Hyperliquid is paid every hour."
- Premium plus interest. The rate is the hour's average premium plus a clamped interest term:
F = P + clamp(interest rate - P, -0.0005, 0.0005). "The premium is sampled every 5 seconds and averaged over the hour." - A fixed interest baseline. The interest component "is predetermined at 0.01% every 8 hours, which is 0.00125% every hour".
- A cap. "Funding on Hyperliquid is capped at 0.5%/hour."
- Paid on the oracle price. A position pays or receives
position_size * oracle_price * funding_rate, on the spot oracle price, not the mark price.
HIP-3 markets use a more responsive premium formula, described on the same page.
Reading a rate
A rate is per hour, so annualizing it is a multiplication by 8,760 hours. The baseline alone, 0.00125% an hour, is about 10.95% a year. A print of 0.0050% an hour on a 10,000 USD position costs or earns 0.50 USD that hour, and about 43.8% a year if it held.
That is why funding history matters: an average over months tells you what a position really cost to hold, which no single print does.
What the official API gives
The perpetuals info endpoint has three funding requests:
fundingHistorytakes acoin, astartTimeand an optionalendTime, and returnscoin,fundingRate,premiumandtime.predictedFundingsreturns the next rate per venue, and "is only supported for the first perp dex".userFundingreturns what one account paid or received.
Responses that take a time range "will only return 500 elements", so a year of hourly prints for one market is 18 pages, each weighing on the per-IP budget described in Hyperliquid API limits.
Every print since May 2023, on a key
Hypedexer serves funding per market back to 12 May 2023, measured on Research, with up to 5,000 rows per call:
curl -H "X-API-Key: $HYPEDEXER_KEY" \
"https://api.hypedexer.com/funding/fundingHistory?coin=BTC&startTime=1704067200000&endTime=1706745600000&limit=5000"Times are in epoch milliseconds; this window is January 2024. Each row carries coin, fundingRate, premium and time, the same shape as the official request, so code written for one reads the other.
In pandas, the average annualized rate of the month:
import requests, pandas as pd
rows = requests.get(
"https://api.hypedexer.com/funding/fundingHistory",
params={"coin": "BTC", "startTime": 1704067200000, "endTime": 1706745600000, "limit": 5000},
headers={"X-API-Key": "YOUR_API_KEY"},
).json()
df = pd.DataFrame(rows)
df["fundingRate"] = df["fundingRate"].astype(float)
print(f"{df['fundingRate'].mean() * 8760:.2%} a year on average")What a wallet paid or received
Per account, GET /funding/userFunding takes a user address and a time range, and returns each payment with its coin, the position size and the USDC amount, positive when the wallet received funding and negative when it paid. The docs give its coverage: complete from 27 September 2025.
For a day-by-day total alongside PnL, fees and transfers, the daily statements carry funding paid or received per day.
FAQ
How often is funding paid on Hyperliquid? Every hour.
How far back does Hyperliquid funding history go on Hypedexer? To 12 May 2023, per market.
What is the maximum funding rate on Hyperliquid? Funding is capped at 0.5% an hour.
How do I see the funding rate live, beside other venues? The live examples page shows the predicted rate per venue from the public API, beside the history a key returns.