Skip to main content
POST
/
info
fundingHistory | Hyperliquid Info API
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "coin": "<string>",
  "startTime": 123,
  "endTime": 123
}
'
{
  "coin": "<string>",
  "fundingRate": "<string>",
  "premium": "<string>",
  "time": 123
}

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

POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json

​
Request

​
type
string
default:"fundingHistory"
required
Always "fundingHistory".
​
coin
string
required
The asset symbol, e.g. "BTC". HIP-3 markets use the deployer-prefixed form.
​
startTime
int
required
Unix timestamp in milliseconds. Inclusive lower bound for the window.
​
endTime
int
Unix timestamp in milliseconds. Inclusive upper bound. Defaults to current server time when omitted.

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "fundingHistory",
    "coin": "BTC",
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }'

​
Response

An array of funding-interval objects, oldest first. 
[
  {
    "coin": "BTC",
    "fundingRate": "0.0000054021",
    "premium": "-0.0004567829",
    "time": 1735693200000
  }
]

​
Field descriptions

fundingRate and premium are returned as decimal strings, preserving upstream precision. Do not parse them as floats.
​
coin
string
The asset the funding interval is for - echoes the request coin.
​
fundingRate
string
The funding rate applied for this interval (decimal string, e.g. "0.0000125").
​
premium
string
Mark-vs-oracle premium at the time the funding was computed (decimal string).
​
time
int
Unix timestamp in milliseconds when the funding interval was applied.

delegatorHistory

reconstruct the sequence of HYPE staking events behind the totals shown in delegatorSummary.

userFunding

fetch a user’s per-coin funding payment history within a time window for funding-only P&L attribution.

userNonFundingLedgerUpdates

fetch a user’s USDC and account ledger history within a time window, excluding funding payments, for…
Last reviewed: 2026-06-13