BlogFor traders, quants and researchers

Hyperliquid Funding Rate History, Since May 2023

How Hyperliquid funding works, where the official API stops, and how to pull every hourly funding print since May 2023, plus what a wallet paid.

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:

  • fundingHistory takes a coin, a startTime and an optional endTime, and returns coin, fundingRate, premium and time.
  • predictedFundings returns the next rate per venue, and "is only supported for the first perp dex".
  • userFunding returns 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:

public: the next print, predictedwith a key: every hourly print, back to 2023-05-12
bash
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:

python
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.

Keep reading.

  • For market makers and quant teams

    Hyperliquid Data for Market Makers: Book History, L4, Flow

    Hyperliquid order book history since April 2024, the live L4 book with each order's owner, counterparty flow and funding since 2023: data for market makers.

    • Order book history, since April 2024
    • The live order-level book (L4), with owners
    • Who is hitting you: flow attribution
    • +3

    4 min read

  • For funds, auditors and tax tools

    Daily Account Statements for Any Hyperliquid Address

    Daily balances, positions, PnL, funding, fees, deposits and withdrawals for any Hyperliquid wallet, as JSON or CSV. For funds, auditors and tax tools.

    • What a daily statement contains
    • Who it is for
    • How to get it
    • +1

    3 min read

  • For traders, risk desks and dashboards

    Hyperliquid Liquidations Data: History, Live and Stats

    How Hyperliquid liquidations work, why the official API shows them per account, and how to get them all: history, a live stream and stats.

    • How a position is liquidated
    • What the official API shows
    • Every liquidation, on a key
    • +1

    3 min read

Start free: 5,000 credits a month, no card.