fundingHistory | Hyperliquid Info API
Info API
fundingHistory | Hyperliquid Info API
Hyperliquid fundingHistory: fetch a coin’s historical funding rates and premiums over a time window for funding analytics and basis strategies.
POST
fundingHistory | Hyperliquid Info API
Credit Cost
1 per call
Processing
Realtime
type: "fundingHistory" is used to fetch a coin’s historical funding rates and premiums over a time window for funding analytics and basis strategies.
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "fundingHistory", "coin": "..."}. - Each response contains at most 500 entries per call.
- This is market-wide funding history for a coin. For a single wallet’s actual funding payments, use userFunding instead.
- For the current funding rate alongside live market context, use metaAndAssetCtxs.
[startTime, endTime] window. Each entry carries the funding rate that was applied and the mark-vs-oracle premium at that time. Use it for funding-rate charts, basis/carry analytics, and historical funding P&L modeling.
This is a global, non-user-keyed type. Page through time by advancing startTime.
Endpoint
Request
string
default:"fundingHistory"
required
Always
"fundingHistory".string
required
The asset symbol, e.g.
"BTC". HIP-3 markets use the deployer-prefixed form.int
required
Unix timestamp in milliseconds. Inclusive lower bound for the window.
int
Unix timestamp in milliseconds. Inclusive upper bound. Defaults to current server time when omitted.
Example
Response
An array of funding-interval objects, oldest first.Field descriptions
fundingRate and premium are returned as decimal strings, preserving upstream precision. Do not parse them as floats.string
The asset the funding interval is for - echoes the request
coin.string
The funding rate applied for this interval (decimal string, e.g.
"0.0000125").Mark-vs-oracle premium at the time the funding was computed (decimal string).
int
Unix timestamp in milliseconds when the funding interval was applied.
Related endpoints
allMids
fetch the current mid price for every actively traded asset in a single call.
candleSnapshot
fetch historical OHLCV candles for a coin and interval over a time window for charting and…
l2Book
fetch an aggregated Level-2 order book snapshot for a single coin - bids and asks as price, size,…
l2BookDiffSnapshot
fetch a full-depth L2 order book snapshot for one coin, with height, epoch, and seq to bootstrap…