Skip to main content
POST
fundingHistory | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "fundingHistory" is used to fetch a coin’s historical funding rates and premiums over a time window for funding analytics and basis strategies.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"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.
Returns the sequence of applied funding intervals for a single coin within a [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").
string
Mark-vs-oracle premium at the time the funding was computed (decimal string).
int
Unix timestamp in milliseconds when the funding interval was applied.

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…
See all Hyperliquid endpoints: Overview hub · Info API reference Last reviewed: 2026-06-13